Star Snippets Logo

snippets.com

Richiedi rich snippet online

Esempi di integrazione


Generale

Il progetto star-snippets consta di 3 diverse componenti che sono presentate nell'ordine a seguire. Per usufruire dell'intera gamma delle funzioni (stelle-valutazione + rich snippet Disponibilità), devono essere integrate tutte e 3 le componenti.

HTML Snippet

Lo snippet HTML serve a definire il punto della pagina dove sarà visualizzato lo star ranking. Inoltre lo snippet HTML permette di adattare l'aspetto delle stelle con Parametri di configurazione. Nel caso più semplice basta il seguente snippet per visualizzare nella pagina una valutazione rich snippet.

<body>
  ...
  <star-snippet></star-snippet>
  ...
</body>

Javascript Code

Il codice Javascript viene utilizzato per trovare nella pagina gli snippet HTML, selezionare i relativi Parametri di configurazione e quindi integrare le stelle nel corrispondente punto e nella configurazione desiderata. Per evitare che l'integrazione modifichi la velocità di caricamento del sito, si consiglia di integrare il codice Javascript direttamente prima del body tag finale (</body>).

Come mostra Pagina possibilità di adattamento, gli snippet HTML insieme al seguente codice Javascript sono sufficienti per integrare una o più stelle di valutazione (rating) in una pagina web. In questo modo anche gli altri visitatori della pagina possono visualizzare le valutazioni e pubblicare la loro valutazione.

<body>
  ...
  <!-- star-snippets.com -->
  <script>
    (function() {
      function async_load(){			
        var s = document.createElement('script');
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'http://star-snippets.com/script';
        //s.src = 'http://star-snippets.com/script?prevent_cache=' + new Date().getTime(); //Esiste l'opzione di vietare la caching.      
        var x = document.getElementsByTagName('script')[0];
        x.parentNode.insertBefore(s, x);
      }
      if (window.attachEvent)
        window.attachEvent('onload', async_load);
      else
        window.addEventListener('load', async_load, false);
    })();
  </script>
</body> <!-- Integrare direttamente dopo il body tag finale -->

PHP Code (Java, etc.)

La terza ed ultima componente serve a generare dalle valutazioni degli utenti Rich Snippet, in modo che i motori di ricerca come Google visualizzino le valutazioni già nell'elenco dei risultati. In questo modo ai siti che sono stati valutati positivamente viene attribuita già nella ricerca una maggiore affidabilità e quindi in genere vengono cliccati più frequentemente.

In principio è possibile ricaricare i tag rich snippet anche con Javascript (Ajax). Però in questo caso i crawler del motore di ricerca devono ricevere il tag direttamente alla distribuzione della pagina, per cui i motori di ricerca ignorano i rich snippet caricati con Javascript (Ajax). Per integrare i rich snippet al momento della distribuzione della pagina, si può farne richiesta in PHP (o un'altra lingua di preferenza) a star-snippets.com che trasmette l'attuale valutazione della pagina in tag rich snippet zippati. Dopo di ciò si deve semplicemente procedere a rilasciare questi tag, che vengono quindi riconosciuti dai crawler dei motori di ricerca e presi in considerazione nell'elaborazione dei risultati di ricerca.

<body>
  ...
  <?php
    //Il parametro url deve coincidere con il parametro href del codice Javascript    
    $url = "http://star-snippets.com/rating?url=http://www.example.com";
			
    $title = "Pagina campione";
			
    $description = "Una descrizione per la mia pagina campione";
    
    if($title != "")
    {
      $url .= "&name=".rawurlencode($title);
    }
    
    if($description != "")
    {
      $url .= "&description=".rawurlencode($description);
    }
    
    $timeout = 10;
    
    try {
    
      $streamContext = stream_context_create(array('http' => array('timeout' => $timeout)));
      
      $response = file_get_contents($url, false, $streamContext);

      if (!$response)
      {}
      else
      {
        echo $response;
      }
    } catch (Exception $ex) {
    }
			
  ?>
  ...
</body>

Avviso

Se lo scrip soprastante genera un errore/avviso perché la funzione 'file_get_contents' non è disponibile sul vostro host, potete usare al suo posto il seguente codice.

// Devi decommentare questa riga.
// $response = file_get_contents($url, false, $streamContext);

// In sostituzione usa le seguenti righe
$session = curl_init($url);
curl_setopt($session, CURLOPT_HEADER, false);  
curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
curl_setopt($session, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($session);
curl_close($session);
  

Joomla (1.5, 1.6, 2.5, 3.0)

L'integrazione in Joomla necessita di alcuni adattamenti in confronto a Standard. L'integrazione è molto semplice se si ricorre all'installazione di un plugin per Joomla. Cliccate il pulsante seguente per scaricare il plugin rich snippet.

Scarica il plugin del rich snippet per Joomla

In alternativa potete naturalmente ricorrere anche alla procedura manuale per procedere all'integrazione di rich snippet. Questo permette una maggiore elasticità, ma è anche più impegnativa.

HTML Snippet

Lo snippet HTML può essere integrato in qualsiasi punto (p. es. contributo, modulo banner, ecc.).

<body>
  ...
  <star-snippet></star-snippet>
  ...
</body>

Javascript e codice PHP

Il seguente code può essere integrato direttamente prima del body tag finale nel relativo template Joomla (index.php).

<body>
  ...
  
  <?php
    
    $doc = JFactory::getDocument();
    
    $url = "http://star-snippets.com/rating?url=".JURI::current();
    
    if($doc->getTitle() != "")
    {
      $url .= "&name=".rawurlencode($doc->getTitle());
    }

    if($doc->getDescription() != "")
    {
      $url .= "&description=".rawurlencode($doc->getDescription());
    }
    
    $timeout = 10;
    
    try {
      $streamContext = stream_context_create(array('http' => array('timeout' => $timeout)));
      
      $response = file_get_contents($url, false, $streamContext);

      if (!$response)
      {}
      else
      {
        echo $response;
      }
    } catch (Exception $ex) {
    }
			
  ?>

  <!-- star-snippets.com -->
  <script>
    (function() {
      function async_load(){			
        var s = document.createElement('script');
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'http://star-snippets.com/script';
        //s.src = 'http://star-snippets.com/script?prevent_cache=' + new Date().getTime(); //Esiste l'opzione di vietare la caching.      
        var x = document.getElementsByTagName('script')[0];
        x.parentNode.insertBefore(s, x);
      }
      if (window.attachEvent)
        window.attachEvent('onload', async_load);
      else
        window.addEventListener('load', async_load, false);
    })();
  </script>
</body>

Avviso

Se lo scrip soprastante genera un errore/avviso perché la funzione 'file_get_contents' non è disponibile sul vostro host, potete usare al suo posto il seguente codice.

// Devi decommentare questa riga.
// $response = file_get_contents($url, false, $streamContext);

// In sostituzione usa le seguenti righe
$session = curl_init($url);
curl_setopt($session, CURLOPT_HEADER, false);  
curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
curl_setopt($session, CURLOPT_TIMEOUT, $timeout);
$response = curl_exec($session);
curl_close($session);
  

WordPress

Anche l'integrazione di rich snippet nel blog software WordPress è molto semplice se si ricorre all'installazione di un plugin per WordPress. Premere il pulsante seguente per scaricare il plugin per rich snippet.

Scarica il plugin del rich snippet per WordPress

Logo star-snippets.com