Simple RSS Editor

Required GET-parameter

url — RSS feed URL for processing

Optional GET-parameters: purpose and processing order

	Parameter name	Value type	Sense of value element	What Does It Do
1	`amp`	presence/absence	do/don't do	It replaces all `&` occurrences with `&` (cases like `&amp;`, `&quot;`, etc.)
2	[it's always executed]	—	—	It replaces all HTML entities with appropriate number code in accord with XML standard, e.g. replacing `"` with `"`
3	`add_namespace`	string	namespace	It adds namespace by means of `add_namespace` value pasting in the attribute list of `rss` tag
4	`remove`	string or array of strings	tag name	It removes all listed tags
5	`rename_from` and `rename_to`	strings or same length arrays of strings	tag name before and after	It renames `rename_from` tag to `rename_to`. If parameters are arrays then rename `rename_from[i]` tag to `rename_to[i]` for each `i`
6	`split`	string or array of strings	tag name	It splits tag content into words (assumption: tag content in CamelCase style) and put each word into the new tags with the same name
7	`replace_description`	string	XPath 1.0 expression	It extracts values from a webpage of each RSS item (webpage URL is extracted from a `<link>` if it exists, otherwise item is ignored) using XPath expression and replaces content of `<description>` element with extracted joint (with separator `PHP_EOL`) value. Note: web page content is being extracted as is, in other words if XPath expression extracts whole HTML tags then description will be contain them.
8	`extend_description`	string	XPath 1.0 expression	It extracts values from a webpage of each RSS item (webpage URL is extracted from a `<link>` if it exists, otherwise item is ignored) using XPath expression and appends extracted joint (with separator `PHP_EOL`) value to content of `<description>` element. Note: web page content is being extracted as is, in other words if XPath expression extracts whole HTML tags then description will be contain them.
9	`break`	string or array of strings	tag name	It pastes `<br/>` into the tag content instead of each `\n` and `\r` character (multiple consecutive characters replaced with single `<br/>`)
10	`cdata`	string or array of strings	tag name	It wraps tag content in `<![CDATA[ ... ]]>` block
11	`replace_from`, `replace_to`	string or array of strings	regular expression	These and the two following parameters are for a tag content replacement. It replaces each match of `replace_from` (or `replace_from[i]`) regexp in the content of tag `replace_in` (or `replace_in[i]`) in accord with `replace_to` (or `replace_to[i]`) regexp. Regexps are in PCRE notation, but starting and ending `/` character must be absent. These parameters can be used for the ordinary replacement, but `\ + * ? [ ^ ] $ ( ) { } = ! < > \| : -` characters must be escaped by a `\` character (e.g, `\(`).
11	`replace_in`	string or array of strings	tag name	Tag which content will be replaced. If its value is `` then replacement will be in each* tag of feed (including `<pubDate>`, `<link>`, etc.).
11	`replace_sens`	presence/absence	match case or not	Case sensitivity. If `replace_sens` (or `replace_sens[i]`) is passed then replacement will be case sensitive else not.
12	`add_category`	string	XPath 1.0 expression	It extracts values from a webpage of each RSS item (webpage URL is extracted from a `<link>` if it exists, otherwise item is ignored) using XPath expression and add `<category>` elements (to the appropriate RSS item) for each extracted value. XPath-expression must extract the final text (array of texts) only
13	`include`	string or array of string	Regular expression (PCRE) without wrapped slashes `/`	It leaves items where title, description or category matches at least one regular expression
14	`exclude`	string or array of string	Regular expression (PCRE) without wrapped slashes `/`	It leaves items where title, description and category do not match all regular expressions

Script constants

Several configuration constants are defined at the beginning of index.php script that can be modified:

DEBUG is whether to use debug mode (make some additional actions for debugging if it's enabled). Default value: false.
MIN_DOWNLOAD_DELAY is the minimum delay in seconds between RSS-elements' web-pages fetching. Every actual delay is a random value between minimum and maximum values. Default value: 0.12 (seconds).
MAX_DOWNLOAD_DELAY is the maximum delay in seconds between RSS-elements' web-pages fetching. Every actual downloading delay is a random value between minimum and maximum values. Default value: 0.94 (seconds).
USE_WEBPAGE_CACHING is whether to cache downloaded web-pages to reuse if it's necessary. Default value: true.

Examples

Replacing & with & in the tags content, adding xmlns:yandex="http://news.yandex.ru/" namespace, removing description tag, renaming full-text tag (from yandex namespace) to description, wrapping content of title and description tags into CDATA block, adding <br/> instead of break lines characters in the description tag content, also replacing all ё occurrences with е (case insensitive) in thedescription tag content: in the RSS feed http://milknews.ru/index/novosti-moloko.rss
```
index.php?url=http%3A%2F%2Fmilknews.ru%2Findex%2Fnovosti-moloko.rss&amp&add_namespace=xmlns%3Ayandex%3D%22http%3A%2F%2Fnews.yandex.ru%2F%22&remove=description&rename_from=full-text&rename_to=description&cdata[]=title&cdata[]=description&break=description&replace_from=ё&replace_to=е&replace_in=description
```
Replacing description of each news with content of news web-page, that matches XPath expression //div[@class='m-block__text-wrapper']/p in the RSS feed http://www.fontanka.ru/fontanka.rss
```
index.php?url=http%3A%2F%2Fwww.fontanka.ru%2Ffontanka.rss&replace_description=%2F%2Fdiv%5B%40class%3D%27m-block__text-wrapper%27%5D%2Fp
```
Filtering RSS items: it leaves only items that contains substring 'font' and does not contain 'fonts'
```
index.php?url=https://feeds.feedburner.com/CssTricks&include=font&exclude=fonts
```

Простенький редактор RSS-ленты

Обязательный GET-параметр

url — URL RSS-ленты для обработки

Необязательные GET-параметры: возможности и порядок их выполнения

	Имя параметра	Тип каждого из параметров	Семантика элемента типа	Действие
1	`amp`	наличие/отсутствие	делать/не делать	замена всех вхождений `&` на `&` (для случаев вида `&amp;`, `&quot;` и т.п.)
2	[автоматически всегда]	—	—	замена всех HTML-сущностей на их числовой код, чтобы соответствовать XML, например, `"` заменяется на `"`
3	`add_namespace`	строка	пространство имен	добавление пространства имен путем простой вставки содержимого `add_namespace` в список атрибутов тега `rss`
4	`remove`	строка или массив строк	имя тега	удаление всех тегов с перечисленными именами
5	`rename_from` и `rename_to`	строки или одинаковых длин массивы строк	имя тега до и после	переименование тега с именем `rename_from` в имя `rename_to`, а в случае массивов переименование тега с именем `rename_from[i]` в `rename_to[i]`
6	`split`	строка или массив строк	имя тега	разбиение содержимого тега с заданным именем на отдельные слова (предполагая, что изначальное содержимое оформлено в стиле CamelCase) и помещение их в нижнем регистре в отдельные теги с тем же изначальным именем
7	`replace_description`	string	XPath 1.0 expression	Заменяет содержимое `<description>` каждого RSS-элемента на извлеченое XPath-выражением значение (в случае нескольких значений их содержимое конкатенируется с разделителем новая строка — `PHP_EOL` ) с веб-страницы RSS-элемента (адрес которой извлекается из `<link>`, если он есть, иначе RSS-элемент игнорируется). Замечание: контект с веб-страницы извлекается как есть, иными словами, если XPath-выражение извлекает целые теги, то в описании будет этот же HTML-код.
8	`extend_description`	string	XPath 1.0 expression	Дополняет содержимое `<description>` каждого RSS-элемента извлеченым XPath-выражением значением (в случае нескольких значений их содержимое конкатенируется с разделителем новая строка — `PHP_EOL` ) с веб-страницы RSS-элемента (адрес которой извлекается из `<link>`, если он есть, иначе RSS-элемент игнорируется). Замечание: контект с веб-страницы извлекается как есть, иными словами, если XPath-выражение извлекает целые теги, то в описании будет этот же HTML-код.
9	`break`	строка или массив строк	имя тега	вставка `<br/>` внутри каждого тега с заданным именем заместо переносов строк `\n` и `\r` (если идет несколько переносов подряд, то заменяется лишь на одну вставку `<br/>`)
10	`cdata`	строка или массив строк	имя тега	заворачивание содержимого тегов с заданным именем в структуру `<![CDATA[ ... ]]>`
11	`replace_from`, `replace_to`	строка или массив строк	регулярное выражение	эти и два последующих параметра служат для замен в оборачиваемых тегами текстах. В теге с именем `replace_in` всякое соответствие регулярному выражению `replace_from` (в нотации PCRE, без окаймляющих символов `/`) заменяется в соответствии с регулярным выражением `replace_to`. Параметры могут использоваться для обычной замены, только любой из символов `\ + * ? [ ^ ] $ ( ) { } = ! < > \| : -` должен быть экранирован символов `\` (например, `\(`).
11	`replace_in`	строка или массив строк	имя тега	может принимать специальное значение `*`, что приведёт к поиску и замене соответствий во всех тегах, включая служебные (`<pubDate>`, `<link>` и др.).
11	`replace_sens`	наличие/отсутствие или массив наличий/отсутствий	учитывать регистр или нет	Если для текущей пары регулярных выражений присутствует `replace_sens`, то поиск ведётся с учётом регистра, иначе без учёта.
12	`add_category`	строка	XPath-выражение 1.0	добавление каждому RSS-элементу категорий `<category>`, содержимое которых определяется XPath-выражением (XPath 1.0), извлекающее список чего-либо со страницы этого RSS-элемента (адрес берётся из тега `link`, если он есть), впоследствии преобразуемое в список строк. XPath-выражение должно извлекать сразу нужную информацию — значение содержимого или атрибута тега
13	`include`	строка или массив строк	Регулярное выражение в стиле PCRE без символа `/` в начале и конце	оставлять только те RSS-элементы, чьи заголовок, описание или категории соответстувуют хотя бы одному регулярному выражению
14	`exclude`	строка или массив строк	Регулярное выражение в стиле PCRE без символа `/` в начале и конце	оставлять только те RSS-элементы, чьи заголовок, описание и категории не соответстувуют всем регулярным выражениям

Пример работы параметра split: подано значение split=tag, поэтому было <tag>КрепостьЧПЗдоровьеНебо</tag>, стало <tag>крепость</tag><tag>чп</tag><tag>здоровье</tag><tag>небо</tag>

Константы скрипта

В начале скрипта index.php определены несколько конфигурационных констант, которые можно менять на свое усмотрение:

DEBUG — использовать или нет режим отладки (по факту режим отладки лишь делает некоторые дополнительные действия). Значение по умолчанию: false.
MIN_DOWNLOAD_DELAY — минимальная задержка в секундах между загрузками веб-страниц RSS-элементов. Величина задержки между загрузками веб-страниц представляет собой случайное значение между минимальным и максимальным значениями. Значение по умолчанию: 0.12 (секунд).
MAX_DOWNLOAD_DELAY — максимальная задержка в секундах между загрузками веб-страниц RSS-элементов. Величина задержки между загрузками веб-страниц представляет собой случайное значение между минимальным и максимальным значениями. Значение по умолчанию: 0.94 (секунд).
USE_WEBPAGE_CACHING — кэшировать или нет загруженные веб-страницы для повторного использования в случае необходимости. Значение по умолчнию: true.

Примеры использования

В RSS-ленте http://milknews.ru/index/novosti-moloko.rss замена & на &, добавление пространства имен xmlns:yandex="http://news.yandex.ru/", удаление тега description, переименования тега full-text (из пространства yandex) в description, заворачивание в CDATA содержимое тегов title и description, а также добавление <br/> заместо переносов строк в содержимом тега description, дополнительно к этому проводится замена всех вхождений буквы ё на е (без учёта регистра) в тегах с именем description:
```
index.php?url=http%3A%2F%2Fmilknews.ru%2Findex%2Fnovosti-moloko.rss&amp&add_namespace=xmlns%3Ayandex%3D%22http%3A%2F%2Fnews.yandex.ru%2F%22&remove=description&rename_from=full-text&rename_to=description&cdata[]=title&cdata[]=description&break=description&replace_from=ё&replace_to=е&replace_in=description
```
В RSS-ленте http://www.fontanka.ru/fontanka.rss замена описания новостей на то, что содержится на веб-странице новости, соответствующее XPath-выражению //div[@class='m-block__text-wrapper']/p
```
index.php?url=http%3A%2F%2Fwww.fontanka.ru%2Ffontanka.rss&replace_description=%2F%2Fdiv%5B%40class%3D%27m-block__text-wrapper%27%5D%2Fp
```
Фильтрация RSS: оставляет только те RSS-элементы, в которых упоминается строка 'font', но при этом не упоминается строка 'fonts'
```
index.php?url=https://feeds.feedburner.com/CssTricks&include=font&exclude=fonts
```

woxcab / rss_editor