Continuando con los ejemplos de Twitter API en Ruby on Rails (parte 1) , aquí puedes encontrar 3 ejemplos más para cerrar el tutorial:

EJEMPLO #3:

Si necesitas buscar tweets que contengan una serie de palabras claves en su texto haces un array de topicos separados por coma y lo evaluas en la consulta. Me he dado cuenta eso si, que no se si es un bug de la API de twitter, pero no hace caso a “no incluir” los retweets. he revisado esta misma duda en los foros de twitter developer, pero no he llegado a una respuesta de por qué a veces no hace caso a la consulta. (tarea para la casa)

def index  
   topics = ["hack4good","hack4goodsantiago"]
   @search = $client.search(topics.join(","), :include_rts => false).take(3).collect
end

En la Vista “index” el loop es el mismo:

 <ul class="list-unstyled  text-gris small">                         
   <% @search.each  do |tweet| %>
    <li>
    <span class="glyphicon glyphicon-music text-info"></span>&nbsp; <%= tweet.text%> 
    <span class="text-gris-oscuro">  <%= time_ago_in_words(tweet.created_at) %></span>       
   </li>
   <%  end %>
   <a href="http://twitter.com/nombredeusuario" title="Twitter">
   <%= image_tag("twittericono.png", class:"pull-right") %>
   </a>
 </ul>

EJEMPLO #4:

Realizar una búsqueda por ubicación del Usuario. Para obtener las coordenadas Latitud y longitud de algun punto geográfico use ésta página que puede servir.

El atributo geocode(latitud, longitud,radio en kms ó millas) tiene 3 parametros requeridos. aquí puse unas coordenadas aproximadas de Santiago, Chile. y los tweets que resultan de la busqueda deberían un set de registros de Twitteros que coincidan que en su perfil de twitter “tweet. user.location” tienen “Santiago, chile” configurado.

@search = $client.search("reciclaje -rt",:result_type=>'recent',:geocode=>"-33.4691199,-70.641997,100km").take(18).collect

En la View index vamos a cambiar radicalmente el diseño y usaremos Bootstrap 3 y Mansory Gallery para realizar una vista más entretenida

Mostrar Tweets con Bootstrap 3 y Mansory Gallery

<div class="jumbotron"> 
      &nbsp; <div id="container">
           <div class="row">                   
                    <% @search.each  do |tweet| %>     
                          <div  class="item" style="width:195px; margin:0 auto;"> 
                            <div class="thumbnail">
                            <%= image_tag(tweet.user.profile_image_url("bigger"), class:"pull-left  img-circle") %>
                              <div class="caption">
                               <h3 class="text-right"><%= tweet.user.name %></h3>
                               <p class="small"><%= tweet.user.location %></p>
                                <p><a href="<%= tweet.url %>" class="" >
                                <%= tweet.text%></a>
                                </p>
                                <p>
                                <span class="small text-right"> <%= time_ago_in_words(tweet.created_at) %></span>
                                </p>
                              </div>
                            </div>
                        </div> <!-- //fin .item-->      
                    <%  end %>
              </div>
	  </div><!-- //fin de container-->

– Línea 7: ocupamos un helper de ruby “image_tag” para mostrar la imagen grande del perfil del usuario. aplicando al final una class de bootstrap con un efecto de imagen circular.

<%= image_tag(tweet.user.profile_image_url(“bigger”), class:”pull-left img-circle”) %>

– Linea 9: titulo ajustado a la derecha en donde imprime el Nombre real del Usuario. si quieres el “nombre por pantalla” cambia a tweet.user.screen_name

<h3 class=”text-right”><%= tweet.user.name %></h3>

– Línea 10: imprime en un parrafo con texto pequeño la ubicación escrita por el usuario.

<p class=“small”><%= tweet.user.location %></p>

Linea 11, 12,13: Dentro de un Parrafo agregamos un enlace que te llevará a la url del mismo tweet. y dentro de ese enlace tenemos el texto mismo del tweet.

EJEMPLO #5: BONUS TRACK!

    def buscarhashtag
        if request.GET.include? "q"
           topics =[params[:q]]
                      @search  = $client.search(topics.join(","),:result_type => "recent", :include_rts => 0,:exclude_replies => 0, :count=>12).take(12).collect
        end
    end

Rails.application.routes.draw do
  # The priority is based upon order of creation: first created -> highest priority.
  # See how all your routes lay out with "rake routes".
  get 'welcome/buscarhashtag'
  get 'welcome/index'
  # You can have the root of your site routed with "root"
   root 'welcome#index'
end

<!-- aqui solo cargamos cosas que iran dentro del body-->
<div class="jumbotron">    

<div class="container">

<div class="row">

    <form class="form-horizontal" role="form">
        <div class="form-group">     
            <div class="col-sm-4">
                <input name="q" type="text" class="form-control input-sm pull-left" id="q" placeholder="buscar hashtag"> 
                <button type="submit" class="btn btn-info btn-sm pull-right">Buscar</button>
            </div>     
        </div> 
        
    </form>

</div><!-- /form buscar por hashtag-->

</div>

<div id="container">

<div class="row">

    <% if request.GET.include? "q" %>

    <% @search.each  do |tweet| %>


    <div  class="item" style="width:195px; margin:0 auto;"> 
        <div class="thumbnail">
            <%= image_tag(tweet.user.profile_image_url("bigger"), class:"pull-left  img-circle") %>
            <div class="caption">
                <h3 class="text-right"><%= tweet.user.name %></h3>
                <p class="small"><%= tweet.user.location %></p>
                <p><a href="<%= tweet.url %>" class="" >
                    <%= tweet.text%></a>
                </p>
                <p>
                    <span class="small text-right"> <%= time_ago_in_words(tweet.created_at) %></span>
                </p>
            </div>
        </div>
    </div> <!-- //fin .item-->      
    <%  end %>

    <% else %>
    
        <div class="col-lg-12">
             <p class="text-info ">Qué Quieres buscar?</p>
        </div>

    <% end %><!-- //end if-->

</div><!-- /.row-->
</div><!-- //fin de container-->

</div><!-- //fin de Jumbotron-->

Ruby 2.0 / Rails 4.1.4: Algunos problemas técnicos que puedes tener.

Revisa mi Artículo SSLError: “certificate verify failed” en localhost

Hola, Bienvenidos. He aquí mi primer artículo Twitter Search API y Ruby on Rails. Si quieres integrar twitter en tu sitio web, filtrar hashtag, buscar por tweets en español/inglés, con coordenadas específicas de una región ó buscar dentro de la timeline de un usuario, este tutorial te puede ayudar…eso espero! =D

Voy a recrear el paso a paso de cómo fue mezclar la API de Twitter con un proyecto en ruby on rails, con layout basado en bootstrap 3.

Para partir necesitas:

Ejemplo lo trabajé en Ruby 2.0 en Rails 4.1.4 en mi compu. (Cómo instalar Rails?)

Una cuenta en Heroku y descargar Toolbelt

Tener una cuenta de usuario de Twitter.

Un proyecto de Ruby on Rails creado y operativo desde Localhost:3000

Paso 1: Creando una cuenta en Twitter developer.

1. Crea una cuenta de twitter.

2. Ingresa con tu user y Password a twitter

3. entra a https://apps.twitter.com/

4. click en el boton “create new APP”

5. completar el formulario de la nueva app

3. click en el tab “API KEY”

aqui tienes que reservar en un block de notas (ya parece receta de cocina! 🙂 ) 4 KEYS que twitter te proveerá, las cuales usaremos como “credenciales” de acceso. Las claves “access token/access token secret” se generan una vez que apretas el boton “generate token”.

API key
API secret
Access token
Access token secret

El Access Level yo lo configuré con “read-write”.

Con estos datos estamos ok para entrar a la segunda etapa del desarrollo.

Paso 2: Instalando la Gema Dotenv

Dotend es una gema que emula lo que existe en heroku localmente para poder homologar los ambientes de desarrollo.

Para instalar la gema tienes que escribir en el gemfile:

gem 'dotenv', '~> 0.11.1'

y luego ejecutas en la consola gitbash:

$ gem install dotenv

y ejecutar a continuación:

$ bundle

Paso 2.1: Instalando la Gema Twitter

Twitter gem es una interfaz de Ruby de la API de Twitter.

gem 'twitter', '~> 5.11.0'

y luego ejecutas en la consola gitbash:

$ gem install twitter

y ejecutar a continuación:

bundle

Paso 3: Configurando las Credenciales de Twitter

Para insertar las credenciales de Twitter (api keys) en la aplicación que crearemos, lo haremos de una forma un poco más larga, pero más segura.

1.- Crea un archivo -sin nombre- sólo con extensión “.env” en la raíz del proyecto y pega estos valores.

TWITTER_API_KEY = "aqui-va-tu-clave-twitter-api-key"
TWITTER_API_SECRET = "aqui-va-tu-clave-twitter-api-secret"
TWITTER_ACCESS_TOKEN = "aqui-tu-clave-access-token"
TWITTER_ACCESS_TOKEN_SECRET =  "aqui-tu-clave-access-token-secret"

revisa la imagen del archivo .env aqui

2. Agrega ahora la extensión .env dentro del archivo .gitignore, con esto nos aseguramos que “subes todos los archivos pero no los que están referenciados en el archivo .gitignore” de ésta manera se “ignoran” los datos sensibles al realizar un push a heroku o a github por ejemplo.

revisa la imagen de .gitignore aquí

3. en la consola gitbash tienes que escribir los siguientes comandos (para registrar en heroku cada KEY de twitter, uno a la vez.)

$ heroku config:set TWITTER_API_KEY="************"
$ heroku config:set TWITTER_API_SECRET="************"
$ heroku config:set TWITTER_ACCESS_TOKEN="************"
$ heroku config:set TWITTER_ACCESS_TOKEN_SECRET="************"

luego de cada key agregada verás un mensaje como este:

settings config vars and restarting tunombredesitio...done, v340....

4. Ahora en tu proyecto > config > application.rb puedes poner las variables que contienen tus verdaderas claves de twitter.

      $client = Twitter::REST::Client.new do |config|
            
          config.consumer_key        = ENV['TWITTER_API_KEY']
          config.consumer_secret     = ENV['TWITTER_API_SECRET']
          config.access_token        = ENV['TWITTER_ACCESS_TOKEN']
          config.access_token_secret = ENV['TWITTER_ACCESS_TOKEN_SECRET']
      end

revisa la imagen de tu proyecto > config > application.rb aquí

EJEMPLO #1:

Estoy usando la API “Search” de twitter.

1. Vamos a Proyecto > app > controllers > welcome_controller.rb el ejemplo 1: (screenshoot)

“Listar una máximo de 3 tweets en español con el hashtag #hack4good excluyendo retweets”

def index            
      
@search = $client.search("#hack4good -rt", :lang => "es").take(3).collect 
end

“Listar una máximo de 3 tweets en español con el hashtag #hack4good incluyendo retweets”

def index            
#Ejemplo 2 twitter api: buscar un hashtag especifico de cualquier usuario.
@search = $client.search("#hack4good", :lang => "es").take(3).collect 
end

2. Lo que puse en el controller, hay que mostrarlo por pantalla….eso se hace en la “Vista.

sigue esta ruta Proyecto > app > views > welcome > index.html.erb (screenshot)

 <ul class="list-unstyled  text-gris small">                         
   <% @search.each  do |tweet| %>
    <li>
    <span class="glyphicon glyphicon-music text-info"></span>&nbsp; <%= tweet.text%> 
    <span class="text-gris-oscuro">  <%= time_ago_in_words(tweet.created_at) %></span>       
   </li>
   <%  end %>
   <a href="http://twitter.com/tunombredeusuario" title="Twitter">
   <%= image_tag("iconotwitter.png", class:"pull-right") %>
   </a>
 </ul>

Explicando la vista index línea a línea

El código comienza con un ciclo each en la línea 2 <% @search.each do |tweet| %> se traduce mas o menos así: “por cada item tweet del objeto @search vamos a imprimir por pantalla todos los tweets iterados.

El <%= tweet.text %> es imprimir por pantalla el texto que contiene cada tweet.

El codigo de línea 5 <%= time_ago_in_words(tweet.created_at) %> imprime el tiempo transcurrido del tweet, pero en palabras. para implementar la funcion time_ago_in_words() revisa este link

Finamente el <% end %> cierra el Loop.

El Link que que se ve en linea 8 a la 10 <a href=”…”> imprime un icono de twitter que alc clickearlo se dirige a mi cuenta de twitter.

Así se ve el código del View con los tweets .

EJEMPLO #2:

Otro ejemplo es filtrar tweets de un usuario específico. Para esto seleccionamos un nombre de usuario, en este caso el mio

listar últimos 3 tweets, incluir retweets del user danigattoni_

Luego creamos un objeto @search para invocar a un método llamado “user_timeline” que necesita de 2 parámetros: el username y las opciones.

def index  
   username = 'danigattoni_'
   options = {:count => 3, :include_rts => true}
    @search  = $client.user_timeline(username, options)
end

sigue esta ruta Proyecto > app > views > welcome > index.html.erb (screenshot)

 <ul class="list-unstyled  text-gris small">                         
    <% @search.each  do |tweet| %>
    <li>
      <span class="glyphicon glyphicon-music text-info"></span>&nbsp; <%= tweet.text%> 
      <span class="text-gris-oscuro">  <%= time_ago_in_words(tweet.created_at) %></span>       
    </li>
    <%  end %>
    <a href="http://twitter.com/nombredeusuario" title="Twitter">
      <%= image_tag("twittericono.png", class:"pull-right") %>
    </a>
  </ul>

Continúa en  Twitter Search API + Ruby on Rails (II parte)