Подключение Гуглового Референта к Вашему сайту:
Оно предельно элементарное:
- Расположите в корневой папке сайта фолдер googereferent со всем его содержимым.
Права доступа трогать не надо (в фолдер ничего не пишется), но соблюдайте моду загрузки содержащихся в фолдере файлов (BINARY или ASCII mode). - Подумайте, где Гугловый Референт будет хранить кэш новостей.
Вам нужно выделить под кэш папку, доступную на запись.
Скажем, в Ласто-блоге и Стахановском Портаторе такая папка уже есть (пусть это будет ./data/logs), а вот в нано-CMS она изначально отсутствует. Создайте её в указанном месте для однообразия с правами 777. - На РНР страничке, куда хочется вывести ленту новостей, Вам необходимо обратиться к классу 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 стилей для шаблона ленты, плюс самой ленты.
Это готовый код, который можно выводить на экран, либо втыкать в код страницы с контентом.
Грубо говоря, все эти наисложнейшие настройки пишутся в класс один раз, а далее получившийся код тупо копируется, и в нем меняется только кейворд- тема ленты новостей. И, возможно, число новостей в ленте для этой конкретной страницы.
Далее мы рассмотрим реализацию ленты новостей от Гуглового Референта на примере встраивания её в три типа движков- следующие кнопки навигации, прямо по очереди, пожалуйста.