sokolnikov911/yandex-turbo-pages

PHP7 Yandex Turbo Pages RSS feed generator

PHP7 Yandex Turbo Pages RSS feed generator

Travis CI
Scrutinizer CI

Russian version of README you can find here: README_RU.md.

Yandex Turbo Pages valid RSS feed generator for PHP 7+. In this version type hinting used, so you need at least PHP 7.0.

Version for PHP 5.4 you can find here.

Examples

This example you can find in examples/example.php

// creates Feed with all needed namespaces
$feed = new Feed();

// creates Channel with description and one ad from Yandex Ad Network
$channel = new Channel();
$channel
    ->title('Channel Title')
    ->link('http://blog.example.com')
    ->description('Channel Description')
    ->language('ru')
    ->adNetwork(Channel::AD_TYPE_YANDEX, 'RA-123456-7', 'first_ad_place')
    ->appendTo($feed);

// adds Google Analytics to feed
$googleCounter = new Counter(Counter::TYPE_GOOGLE_ANALYTICS, 'XX-1234567-89');
$googleCounter->appendTo($channel);

// adds Yandex Metrika to feed
$yandexCounter = new Counter(Counter::TYPE_YANDEX, 12345678);
$yandexCounter->appendTo($channel);

// creates first page of feed with link and enabled turbo, description and other content, and appends this page to channel
$item = new Item();
$item
    ->title('Thirst page!')
    ->link('http://www.example.com/page1.html')
    ->author('John Smith')
    ->category('Technology')
    ->turboContent('Some content here!<br>Second content string.')
    ->pubDate(strtotime('Tue, 21 Aug 2012 19:50:37 +0900'))
    ->appendTo($channel);

// creates list of related pages
$relatedItemsList = new RelatedItemsList();

// adds link to first related page
$relatedItem = new RelatedItem('Related article 1', 'http://www.example.com/related1.html');
$relatedItem->appendTo($relatedItemsList);

// adds link to second related page with image
$relatedItem = new RelatedItem('Related article 2', 'http://www.example.com/related2.html',
    'http://www.example.com/related2.jpg');
$relatedItem->appendTo($relatedItemsList);

// appends list of related links to first page
$relatedItemsList
    ->appendTo($item);

// creates another one page with disabled turbo
$item = new Item(false);
$item
    ->title('Second page!')
    ->link('http://www.example.com/page2.html')
    ->author('John Smith')
    ->category('Technology')
    ->turboContent('Yet another content here!')
    ->pubDate(strtotime('Tue, 21 Aug 2012 19:50:37 +0900'))
    ->appendTo($channel);

// displays the generated feed
echo $feed;

For generating content for turbo items you can use Content helper. For example:

// generate header
$menuArray = [
    ['url' => 'http://example/page1.html', 'title' => 'Page title 1'],
    ['url' => 'http://example/page2.html', 'title' => 'Page title 2']
];
$header = Content::header('Main title', 'Second title',
    'http://example.com/image1.jpg', 'Image description', $menuArray);

At this time you can use helpers for generate next elements:

• page header including menu;
• image;
• images gallery;
• share buttons;
• link or phone button;
• comments;
• rating;
• accordion;
• video from own server;
• video from external server;
• ad block position element;
• media-content with slider;
• additional content block;
• search input;
• modal contact form;
• inline contact form.

Examples of using helpers you can find in examples/content_helpers.php.

Installing

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of yandex-turbo-pages

php composer.phar require sokolnikov911/yandex-turbo-pages

After installing, you need to require Composer's autoloader:

require 'vendor/autoload.php';

You can then later update yandex-turbo-pages using composer:

composer.phar update

Requirements

This Yandex Trurbo Pages RSS feed generator requires at least PHP 7.0 (yeahh, type hinting!).

License

This library is licensed under the MIT License.

yandex-turbo-pages's Issues

Should add ad position element

Should add ad position element in Content helper as described here.

Should add search form

Should add search form in Content helper as described here.

Should add block with additional content

Should add block with additional content in Content helper as described here.

Добавить обработку блоков

Channel -> yandex:logo
Channel -> lastBuildDate
Channel -> turbo:analytics type="custom" url=""
Channel -> ttl
Channel -> image (url, title, link)

Item -> guid
Item -> pdalink
item -> yandex:genre
item -> yandex:full-text

ну, как вариант, передайте ownership репозитория, у нас сейчас активно оно используется, допилю.

Should add video block for external video

Should add video block in Content helper as described here.

Should add media slider

Should add media slider in Content helper as described here.

Использование в другом проекте

Добрый день, могу ли я использовать ваши наработки внутри своего плагина для WordPress, который создает ленту для турбо-страниц?

Есть какие-то требования или определённая лицензия?

Не увидел в классе, может ли он генерить тег img для header айтема.

Should add video block

Should add video block in Content helper as described here.

Should add feedback block

Should add feedback block in Content helper as described here.

Should add accordeon element

Should add accordion element as described here.

Should add feedback form

Should add feedback form in Content helper as described here.