Neste artigo vamos finalizar a série Como criar um Theme para Tumblr, na qual ao longo do tempo você pôde aprender todos os principios básicos o que necessita para poder criar themes Tumblr como um verdadeiro profissional, ainda que não tenha os profundos conhecimentos a nível da programação para o fazer. Na prática, esses conhecimentos avançados não são realmente necessários, pelo que a conclusão desta série e a execução dos passos contidos nela não serão um problema para si que não tem extensos conhecimentos de programação. No passado, a abordagem feita através da utilização de frameworks e bibliotecas acabava por sobrelotar com demasiadas coisas. Quantas mais funcionalidades eram adicionadas, mais difícil ficava a tarefa dos usuários terem uma experiência de utilização agradável, tornando a própria plataforma um pouco confusa e pouco intuitiva.

Uma grande questão que se colocou foi, no mundo do blogging, quanto poder será realmente necessário para uma plataforma? Será necessária tanta complexidade para satisfazer todos e quaisquer desejos e necessidades dos usuários? Naturalmente que a resposta a estas questões pode variar dependendo do objetivo que se pretenda dar ao blog, mas Tumblr destacou-se e fez a diferença.

tumblr

Não perca os artigos anteriores desta série:

Neste artigo vamos-lhe falar da utilização da API do Tumblr, que á bastante simples de ser utilizada pois pode ser implementada através de chamadas HTTP, sendo assim extremamente simples de introduzir em um aplicativo.  Este é o último artigo da série Como criar um Theme para Tumblr (Parte VIII), pelo que se chegou a este artigo e não conhece os anteriores, recomendamos vivamente a leitura dos mesmos para que possa não só ficar a conhecer os outros conteúdos como também para poder seguir a linha orientadora introduzida nos artigos, começando desde os princípios básicos da utilização da plataforma até à parte da programação onde entramos no mundo do código Tumblr para lhe dar a conhecer as suas particularidades e possíveis utilizações.

De lembrar que nesta série focámos todos os princípios básicos que você necessita para poder fazer alterações em themes Tumblr ou mesmo, com um pouco de imaginação e outro tipo de conhecimentos a nível de linguagens de programação e estilização, criar o seu próprio theme Tumblr bombástico que poderá eventualmente fazer sucesso na plataforma.

Para aceder à API poderá fazê-lo como XML como JSON, e para aceder a estes dados em formato XML basta dirigir-se a http://seunome.tumblr.com/api/read/:

Como criar um Theme para Tumblr (Parte VIII)

Se pretender aceder em formato JSON dirija-se a http://seunome.tumblr.com/api/read/json/:

Como criar um Theme para Tumblr (Parte VIII)

1. PARÂMETROS

Para determinar os dados que quer obter da API do Tumblr você pode introduzir alguns parâmetros que vão restringir os dados:

  • type: determina o tipo de artigo a devolver, entre text, chat, photo, quote, link, audio e video.
  • id: determina o id específico de um artigo
  • start: o offset do artigo
  • search: vai devolver os artigos que correspondam ao termo da pesquisa
  • tagged: vai devolver artigos que tenham uma determinada tag
  • debug: se introduzir o valor 1, o feed XML irá ser melhorado
  • callback: apenas para JSON, deverá ser igual ao nome da função a ser chamada com o objeto JSON como parâmetro

2. UTILIZAÇÃO

A utilização da API como referimos anteriormente é bastante simples e direta, pelo que apenas terá de inserir os parâmetros e o valor. Vamos agora dar exemplos de utilização para vários tipos de parâmetros:

Vídeo

http://seunome.tumblr.com/api/read/json/?type=video

10 últimos artigos

http://seunome.tumblr.com/api/read/json/?num=10

Artigos que correspondam a uma pesquisa e que estejam incluidos numa tag

http://seunome.tumblr.com/api/read/json/?search=teste&type=quote

Devolver artigos do painel de administração

Para obter todos os artigos disponíveis no seu painel de administração é necessário fazer uma leitura autenticada, pelo que terá de aceder ao seu painel de controlo introduzindo alguns parâmetros, nomeadamente o email, a password e alguns parâmetros que introduzimos anteriormente e que poderá escolher:

http://www.tumblr.com/api/dashboard?email=seuEmail@mail.com&password=suaPassword&debug=1

Devolver artigos que gostou

http://www.tumblr.com/api/likes?email=seuEmail@mail.com&password=suaPassword

Ler páginas

Para obter os conteúdos das páginas do seu Tumblr em um formato XML dirija-se a http://seunome.tumblr.com/api/pages

Criar novos artigos

Se fizermos a junção entre a API do Tumblr e uma linguagem de programação como PHP, é possível criar novos artigos sem sequer entrar no seu painel de administração Tumblr. Então, para criar um artigo utilize http://www.tumblr.com/api/write e introduza as suas credenciais de login, bem como o tipo de artigo e outros parâmetros que pretenda introduzir:

<?php
// autorização
$tumblr_email = 'seuEmail@mail.com';
$tumblr_password = 'suaPasswords';
// Dados
$post_type = 'regular';
$post_title = 'Titulo do artigo';
$post_body = 'conteúdo do artigo.';
// pedido POST
$request_data = http_build_query(
array(
'email' => $tumblr_email,
'password' => $tumblr_password,
'type' => $post_type,
'title' => $post_title,
'body' => $post_body
)
);
$c = curl_init('http://www.tumblr.com/api/write');
curl_setopt($c, CURLOPT_POST, true);
curl_setopt($c, CURLOPT_POSTFIELDS, $request_data);
curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($c);
$status = curl_getinfo($c, CURLINFO_HTTP_CODE);
curl_close($c);

if ($status == 201) {
echo "Successo! O id do novo artigo é $result.\n";
} else if ($status == 403) {
echo 'Email ou Password errados';
} else {
echo "Erro: $result\n";
}
?>

Autenticação de usuários

Para fazer a autenticação de usuários basta aceder a um endereço específico e introduzir as credenciais: http://www.tumblr.com/api/authenticate?email=seuEmail@mail.com&password=suaPassword

isto irá devolver um bloco de conteúdo XML que contém duas tags e vários atributos:

<user> : can-upload-audio, can-upload-aiff, can-upload-video, max-video-byts-uploaded

<tumblelog>: title, type, name, url, avatar-url, is-primary

Então, utilizando PHP é possível fazer coletar a informação de um usuário utilizando as credenciais:

<?php
// Autorização
$tumblr_email = 'seuEmail@mail.com';
$tumblr_password = 'suaPassword';
// Prepare POST request
$request_data = http_build_query(
array(
'email' => $tumblr_email,
'password' => $tumblr_password
)
);
// pedido POST
$c = curl_init('http://www.tumblr.com/api/authenticate');
curl_setopt($c, CURLOPT_POST, true);
curl_setopt($c, CURLOPT_POSTFIELDS, $request_data);
curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($c);
$status = curl_getinfo($c, CURLINFO_HTTP_CODE);
curl_close($c);

if ($status != 200) {
echo "Erro!";
}
$xml = new SimpleXMLElement($result);
?>
<h1>INformação de usuário:</h1>
<ul>
<li>Titulo: <?php echo $xml->tumblelog['title']; ?></li>
<li>Numero de Posts: <?php echo $xml->tumblelog['posts'];
?></li>
<li>Avatar: <br />
<img src="<?php echo $xml->tumblelog['avatar-url'];?>"
alt="<?php echo $xml->tumblelog['title'];?>" /></li>
</ul>

3. FINAL

Este artigo marca o final da série Como criar um Theme para Tumblr (Parte VIII), em que abordámos todos os princípios básicos que você necessita tanto para personalizar um theme existente como também para dar asas à imaginação e criar o seu próprio theme Tumblr. Sugerimos, caso seja do seu interesse que partilhe as suas criações e personalizações aos themes Tumblr neste artigo para que nós e toda a comunidade criativa possa ficar a conhecer, partilhar opiniões e dicas e acima de tudo que se possam trocar conhecimentos de forma a que todos nós possamos aumentar o nosso conhecimento na área. Resta-nos desejar que desfrute dos nossos artigos e que com eles se torne um verdadeiro perito em personalização de themes Tumblr!

Abraço!

 

Autor: Diogo Espinha

Blog do Autor | Artigos do Autor:

Workaholic e totalmente viciado em computadores, Internet e desporto motorizado. Adora praticar desporto, é um curioso da programação em PHP, CSS e HTML5 e não dispensa a companhia do seu Mac OSX 86 Snow Leopard!

  • Explorer - Factory Construction & Ship Building Joomla Theme
  • Justice - Attorney and Law Firm Joomla Template
  • OwnFolio - One Page Personal Portfolio / vCard / Resume / Showcase Joomla Template
  • Big Business - Responsive Template
  • Merab - Creative Multipurpose Drupal 8 Theme
  • Fitness Academy Joomla Template
  • Fruition - Business Joomla Template
  • Educate | Education & Courses, Kindergartens Joomla Template
  • Constructive - Contractors Multipurpose Joomla Landing Page Theme
  • Vina Bubox - VirtueMart Joomla Template for Online Stores
  • BizOne - One Page Parallax Drupal Theme
  • LawHouse - Responsive Lawyers Attorneys Joomla Template

Gostou deste artigo? Então torne-se fã do Blog no Facebook!



Comentários dos Alunos


  1. Vera Golbi
    3 de novembro de 2012

    Olá Diogo!

    Acabei de ler todos os artigos sobre Tumblr, e que são muito bem explicados. :)
    Como já conheço o WordPress, achei bastante interessante essa plataforma pela sua simplicidade.

    Parabéns!!


RSS
Twitter
Facebook
Comentários
ASSINANTES
SEGUIDORES
FÃS
COMENTÁRIOS
7794

Subscrever Newsletter
Subscreva a Newsletter:



Aplicativos Android, iPhone e Muito Mais!




Assine a Escola Criatividade Assine a Newsletter da Escola Criatividade Escola Criatividade no Twitter Escola Criatividade no Facebook Escola Criatividade no Youtube Escola Criatividade no Google Buzz