Подключение Гуглового Референта к Вашему сайту:

Оно предельно элементарное:

  1. Расположите в корневой папке сайта фолдер googereferent со всем его содержимым.
    Права доступа трогать не надо (в фолдер ничего не пишется), но соблюдайте моду загрузки содержащихся в фолдере файлов (BINARY или ASCII mode).

  2. Подумайте, где Гугловый Референт будет хранить кэш новостей.
    Вам нужно выделить под кэш папку, доступную на запись.
    Скажем, в Ласто-блоге и Стахановском Портаторе такая папка уже есть (пусть это будет ./data/logs), а вот в нано-CMS она изначально отсутствует. Создайте её в указанном месте для однообразия с правами 777.

  3. На РНР страничке, куда хочется вывести ленту новостей, Вам необходимо обратиться к классу GoogleReferent - будет удобно сначала оговорить назначение методов этого класса и возможные атрибуты каждого метода, а уж потом рассмотреть, как всё это цепляется к каждому из перечисленных выше движков, да и вообще к чему угодно.

    Управление классом весьма несложное:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    
       $keywords=$title='политика';
     
       include_once ('./googlereferent/googlereferent_template.php');
       include_once ('./googlereferent/googlereferent_css.php');
       include_once ('./googlereferent/googlereferent.inc.php');
     
       $news=new GoogleReferent;
       $news->langsite('ru');       # Язык сайта, возможны значения 'ru' или 'en'
       $news->keywords($keywords);
       $news->codeto('CP1251');     # возможны значения 'ISO-8859-1' 'CP1251' 'UTF-8'
       $news->cachetime(6000);      # Время кэширования в минутах.
       $news->feednumber(10);       # Число новостей в фиде.
       $news->cache('./data/logs'); # относительный путь до папки кэша.
       $news->template($googlereferent_template);
       $news->ini_google_referent();
       $content=$echo=$googlereferent_css.$news->getnews();
    Пояснения к строкам кода, условно пронумерованных слева.

    • В первой строке мы задаём тему ленты новостей и заодно титл страницы.
    • В строках с третьей по пятую мы подключаем:

      - шаблон для новостийной ленты,
      - стили для этого шаблона,
      - а также сам PHP класс Гуглового Референта.

      При этом исходим из допущений, что фолдер с Гугловым Референтом находится в месте, оговоренном в первом пункте настоящей инструкции. То есть непосредственно в корне движка сайта.
      Если Вам вдруг захочется вместо относительных путей указать абсолютные (URL), воздержитесь от этого. Гарантирую, что ничего хорошего из этого не получится.
    • В седьмой строке мы подключаем наш класс.
    • В восьмой указываем, на каком языке нам нужны новости.
      Возможны два варианта- 'ru' или 'en'.
    • Далее сообщаем классу тему новостийной ленты (через переменную, определённыэ в первой строке).
    • Десятая строка укажет кодировку, в которой надо получить ленту.
    • Одиннадцатая укажет время хранения информации в кэше. В минутах.
      Тут дружите с головой - ежеминутно проверять новости не надо.
      Если по этой теме появляется пару новостей в сутки, то и поставьте длительностью кэширования пятьсот минут. Этого хватит.
      В противном случае сервера Гугла откажут Вам в ослуживании запроса.
    • Двенадцатая строка задаёт число новостей в ленте.
      Оно не может быть больше 10 штук.
      Однако в реальности для какой-то затейливой темы может не сыскаться и десяти штук- тогда новостей в ленте будет меньше.
    • Тринадцатая строка оговаривает место размещения кэша.
      Тут оно такое, как сказано во втором пункте данной инструкции.
    • В 14 строке мы передаём Гугловому Референту через переменную шаблон для новостей в ленте.
    • Далее даём команду работать.
    • Последняя строка- получение в переменную содержимого файла CSS стилей для шаблона ленты, плюс самой ленты.
      Это готовый код, который можно выводить на экран, либо втыкать в код страницы с контентом.

    Грубо говоря, все эти наисложнейшие настройки пишутся в класс один раз, а далее получившийся код тупо копируется, и в нем меняется только кейворд- тема ленты новостей. И, возможно, число новостей в ленте для этой конкретной страницы.

Далее мы рассмотрим реализацию ленты новостей от Гуглового Референта на примере встраивания её в три типа движков- следующие кнопки навигации, прямо по очереди, пожалуйста.