“RSS Transmute for WordPress” Help by CodeRevolution

---

“RSS Transmute for WordPress Help”

---

Table of Contents

1. About the plugin
2. WordPress installation
3. Plugin Settings
4. Summary
5. Sources and Credits

---

About this plugin - top

RSS Transmute is a powerful tool to copy and even automatically edit any RSS feed, from any website from the internet. The generated feeds will be published on your website and they will be automatically updated with new content, each time the original feed is refreshed, without your further intervention.Your only task is to provide the plugin with target RSS feed URLs and and the plugin will do the rest of the job. As a result, you will get your newly generated RSS feeds in seconds!

Even more, you can edit the generated feeds: add your own content to them, automatically translate them, spin the content, merge multiple feeds into a single one!

The plugin will store your RSS feed on your website (similar to RSS feeds that are already present on your site). The plugin will generate a unique URL for each feed you've created (you can change generated feed names). The URL of the new feeds can be used in HTML code at your website or be embedded in any RSS reader or software that manages RSS feeds. It can also be provided to one of many RSS readers or any other RSS-related service.

Once you've created your RSS feed it starts updating automatically, based on the schedule you set in plugin settings. No need to manually regenerate the RSS each time to refresh it, the plugin will do this job for you.

How does it work?

This plugin will crawl the seed RSS feed (or multiple feeds) you define in it's settings and will visit and if configured to do this, it will extract full content from each crawled URL. The extracted content can be processed (word replacement, translation, word spinning or many more supported text operations).

Also, you can automatically generate unlimited number of custom RSS importing rules, that will create an unlimited number of RSS feeds.

Other plugin features:

• Google Translate support - select the language in which you want to create your RSS feeds
• Text Spinner support - automatically modify generated text, changing words with their synonyms
• send custom cookies with the request to the crawled webpage (authentification)
• define publishing constrains: do not publish RSS feed items that do not have images, RSS feed items with short/long title/content
• 'Random Sentence Generator Tool' (generate random relevant sentences - as you define them)
• Maximum/minimum title length RSS feed item limitation
• Maximum/minimum content length RSS feed item limitation
• Add RSS feed item only if predefined required keywords found in title/content
• Add RSS feed item only if predefined banned keywords are not found in the title/content
• Save and restore plugin rule list from file
detailed plugin activity logging
• scheduled rule runs
• And many other cool features

Plugin requirements:

PHP DOM -> how to install it (if you don't have it, but probably you already have it): http://php.net/manual/en/dom.setup.php

WordPress installation - top

YouTube video tutorial:

I also provided a Quick Install Guide to feature an easy plugin installation for everyone.

To make this plugin work, first, you'll need to install the plugin. The easiest method is to take the .zip file you've downloaded and upload it via Plugins > Add New > Upload Plugin in the WordPress Dashboard. Once the plugin is installed, be sure to Activate it.

Now that you've installed and activated the plugin, you'll see a new menu item created inside WordPress called 'RSS Transmute'. First thing first, let's head over to Settings > RSS Transmute and take a look at what options are available.

Plugin Settings - top

Refreshingly, RSS Transmute has a super-simple settings screen. Let's look at first at the settings panel:

Here you can find the steps needed in configuring your plugin even if you have no HTML knowledge at all. You can find options for:

HINT! Don't forget to click the Save button every time you modified your settings, otherwise the modifications will be lost!

Main Settings:

• RSS Transmute Main Switch: Enable or disable the RSS Transmute. This acts like a main switch.
• DeepL Translator Authentication Key (Optional): If you wish to use Deepl for translation, you must enter first a Deepl 'Authentication Key'. If you enter a value here, new options will become available in the 'Automatically Translate Content To' and 'Source Language' fields.
• Google Translator API Key (Optional): If you wish to use the official version of the Google Translator API for translation, you must enter first a Google API Key. Please enable the 'Cloud Translation API' in Google Cloud Console. Translation will work even without even without entering an API key here, but in this case, an unofficial Google Translate API will be used.
• WordPress Feed Refresh Interval: If you wish to set the WordPress feed refresh interval, you can do it using this feature. Please enter the timeout in seconds. If you do not set this feature, the default refresh rate for feeds will be 12 hours. Default is: 43200 (12 hours in seconds)
• Web Proxy Address List: If you want to use a proxy to crawl webpages, input it's address here. Required format: IP Address/URL:port. You can input a comma separated list of proxies.
• Web Proxy Authentification: If you want to use a proxy to crawl webpages, and it requires authentification, input it's authentification details here. Required format: username:password. You can input a comma separated list of users/passwords. If a proxy does not have a user/password, please leave it blank in the list. Example: user1:pass1,user2:pass2,,user4:pass4.
• Shorte.st API Token: If you wish to shorten outgoing links using shorte.st, please enter your API token here. To disable URL shortening, leave this field blank.
• Use Alternate Readability Use alternate readability version to automatically extract text from articles.
• Strip Links From Post Content: Choose if you want to strip links from the post content.
• Strip Links Only From Imported Content: Choose if you want to strip links from the imported post content (keep links that were added afterwards.
• Strip Website Internal Links Only: Choose if you want to strip internal links only from the imported post content (keep links that were added afterwards.
• Strip JavaScript From Crawled Content: Choose if you want to strip JavaScript from the crawled post content.
• Strip HTML From Content: Choose if you wish to strip HTML from crawled content.
• Page Screenshot Width: Input the width of the screenshot that will be generated for crawled pages. This will affect the content generated by the %%item_show_screenshot%% shortcode. The default is 600.
• Page Screenshot Height: Input the height of the screenshot that will be generated for crawled pages. This will affect the content generated by the %%item_show_screenshot%% shortcode. The default is 450.
• Skip Posts With These Words In Their Image Names Do you want to skip posts that have these words in their image names? To disable this feature, leave this field blank. You can also use wildcards in the expressions.
• Timeout for One Request (seconds): Set the timeout (in seconds) for every rule running. I recommend that you leave this field at it's default value (3600).
• Delay Between Request (milliseconds): Set the timeout (in milliseconds) between each subsequest call to the crawled website. Increase this value if the website has a anti-crawling mechanism active. Here you can also input a pair of values, separrated by comma (ex: 300,500). In this case, a random timeout will be selected, between the two values you specified.
• Delay Between Rule Running: Define a number of seconds the plugin should wait between the rule running. Use this to not decrease the use of your server's resources. Leave blank to disable.
• Iframe Resize Width: Resize the iframes that were imported from the custom content. If you want to disable this feature, leave this field blank.
• Iframe Resize Height: Resize the iframes that were imported from the custom content. If you want to disable this feature, leave this field blank.
• Crawled Category Separator: Input the separator character for category assignation from crawled content.
• Add Attributes to Internal Links: Input the attributes you want to set for each internal link from content.
• Add Attributes to External Links: Input the attributes you want to set for each external link from content.
• Replace All URLs from Content With This URL: Do you want to replace all URLs from generated posts content with this predefined URL?
• 'Read More' Button Text: Insert the desired text to be show for the 'Read More' buttons. Exemple: for the %%item_read_more_button%% shortcode or for the excerpt.
• Strip Links From Generated Post Content: Choose if you want to strip links from the generated post content.
• Show Extended Item Information Metabox in Post: Choose if you want to show an extended information metabox under every plugin generated post.
• Enable Logging for Rules: Do you want to enable logging for rules?
• Enable Detailed Logging for Rules: Do you want to enable detailed logging for rules? Note that this will dramatically increase the size of the log this plugin generates.
• Automatically Clear Logs After: Choose if you want to automatically clear logs after a period of time.
• Timeout for Rule Running (seconds): Set the timeout (in seconds) for every rule running. I recommend that you leave this field at it's default value (3600).
• Send Rule Running Summary in Email: Choose if you want to receive a summary of the rule running in an email.
• Email Address: Input the email adress where you want to send the report. You can input more email addresses, separated by commas.
• Minimum Title Word Count: Set the minimum word count for post titles. Items that have less than this count will not be published. To disable this feature, leave this field blank.
• Maximum Title Word Count: Set the maximum word count for post titles. Items that have more than this count will not be published. To disable this feature, leave this field blank.
• Minimum Content Word Count: Set the minimum word count for post content. Items that have less than this count will not be published. To disable this feature, leave this field blank.
• Maximum Content Word Count: Set the maximum word count for post content. Items that have more than this count will not be published. To disable this feature, leave this field blank.
• Banned Words List: Do not include posts that's title or content contains at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Required Words List: Do not include posts that's title or content does not contain at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Strip HTML Elements from Final Content by ID: Strip HTML elements from final content that have this IDs. You can insert more IDs, separeted by comma. To disable this feature, leave this field blank.
• Strip HTML Elements from Final Content by Class: Strip HTML elements from final content that have this class. You can insert more classes, separeted by comma. To disable this feature, leave this field blank.
• Automatically Translate Content To: Do you want to automatically translate generated content using Google Translate?
• Skip Posts That Do Not Have Images: Choose if you want to skip posts that do not have images.
• Skip Posts Older Than a Selected Date: Choose if you want to skip posts that are older than a selected date.
• Choose if you want to skip posts that are older than a selected date. Select the date prior which you want to skip posts.
• Spin Text Using Word Synonyms: Do you want to randomize text by changing words of a text with synonyms using one of the listed methods? Note that this is an experimental feature and can in some instances drastically increase the rule running time!
• First List of Possible Sentences (%%random_sentence%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
• Second List of Possible Sentences (%%random_sentence2%%): Insert some sentences from which you want to get one at random. You can also use variables defined below. %something ==> is a variable. Each sentence must be sepparated by a new line.
• List of Possible Variables: Insert some variables you wish to be exchanged for different instances of one sentence. Please format this list as follows:Variablename => Variables (seperated by semicolon)Example:adjective => clever;interesting;smart;huge;astonishing;unbelievable;nice;adorable;beautiful;elegant;fancy;glamorous;magnificent;helpful;awesome
• Custom HTML Code #1: Insert a custom HTML code that will replace the %%custom_html%% variable. This can be anything, even an Ad code.
• Custom HTML Code #2: Insert a custom HTML code that will replace the %%custom_html2%% variable. This can be anything, even an Ad code.

Rules List Settings Screen:

• ID: This is the ID of the rule.
• Original RSS Feed URL  Input a list of URLs, of the original RSS feeds, you wish to edit.
• Schedule (Hours) Select the interval in hours after which you want this rule to run.
• Max # Feed Items Select the maximum number of items that this rule can create at once in the RSS feed.
• Del: Do you want to delete this rule?
• Feed Name: Set the name of the feed to generate.
• Active: Do you want to enable this rule? You can deactivate any rule (you don't have to delete them to deactivate them).
• Info: The number of items (posts, pages) this rule has generated so far.
• Actions: Do you want to run this rule now? Note that only one instance of a rule is allowed at once.

Advanced Plugin Settings Dropdown Screen:

• Feed Title: Set the title of the generated feed. You can use this shortcode: %%wp_title_rss%% - this will be replaced by the RSS title of your own website. Shortcodes for the source feed info: %%feed_title%%, %%feed_description%%, %%feed_author%%, %%feed_author_link%%, %%feed_author_email%%
• Feed URL: Set the URL of the generated feed. You can use this shortcode: %%wp_url_rss%% - this will be replaced by the RSS URL of your own website
• Feed Description: Set the description of the generated feed. You can use this shortcode: %%feed_description%% - this will be replaced by the RSS description of your own website. Shortcodes for the source feed info: %%feed_title%%, %%feed_description%%, %%feed_author%%, %%feed_author_link%%, %%feed_author_email%%
• Feed Language: Set the language of the generated feed. You can use this shortcode: %%wp_language_rss%% - this will be replaced by the RSS language of your own website
• Feed Update Period: Set the update period that will be stated in the RSS feeds
• Feed Update Frequency: Set the update frequency of the feed.
• Custom RSS Feed Tag Creator (Optional): Custom RSS feed tag creator. Syntax for this field: custom_tag_name => custom_tag_content (to specify multiple shortcodes and crawling values, separate them by a new line. Example: CustomTagName => value
• Generated Feed Items Title: Set the title of the generated feed items. You can use the following shortcodes: %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_content%%, %%item_url%%, %%item_cat%%, %%item_content_plain_text%%, %%item_screenshot_url%%, %%item_show_screenshot%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_description%%, %%item_pub_date%%. You will also be able to use the custom shortcodes defined in the 'Custom Shortcode Creator' feature from below. You will also be able to use the custom shortcodes defined in the 'Custom Shortcode Creator' feature from below.
• Generated Feed Items Content: Set the content of the generated feed items. You can use the following shortcodes: %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_content%%, %%item_url%%, %%item_cat%%, %%item_content_plain_text%%, %%item_screenshot_url%%, %%item_show_screenshot%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_description%%, %%item_pub_date%%. You will also be able to use the custom shortcodes defined in the 'Custom Shortcode Creator' feature from below.
• Feed Items URL Append: Set the publication URL parameter text that will be added to the URL of the crawled website.
• Feed Items PubDate: Set the publication date of the generated feed items. You can use the following shortcodes: %%item_pub_date%%, %%current_time%%
• Automatically Get Categories: Do you want to automatically get categories from feed items?
• Additional Feed Item Categories: Input a list of categories that you want to be added to the list of automatic categories. Input more categories, separated by comma. Ex: category1, category2, category3
• Categories To Remove: Input a list of categories that you want to remove from the list of automatic categories. Input more categories, separated by comma. Ex: remove1, remove2, remove3
• Replace Article Image With Royalty Free Image: Do you want to replace the imported article's image with a royalty free image? Please note that for this feature to function you must configure the plugin (add API keys) in the plugin's 'Main Settings' menu -> 'Royalty Free Image Importing Options' section.
• Custom RSS Feed Item Tag Creator (Optional): Custom RSS feed tag creator. Syntax for this field: custom_tag_name => custom_tag_content (to specify multiple shortcodes and crawling values, separate them by a new line. Example: CustomTagName => The feed item title is: %%item_title%% - You can use the following shortcodes: %%custom_html%%, %%custom_html2%%, %%random_sentence%%, %%random_sentence2%%, %%item_title%%, %%item_conten%%, %%item_url%%, %%item_cat%%, %%item_content_plain_text%%, %%item_screenshot_url%%, %%item_show_screenshot%%, %%item_read_more_button%%, %%item_show_image%%, %%item_image_URL%%, %%item_description%%, %%item_pub_date%%. You will also be able to use the custom shortcodes defined in the 'Custom Shortcode Creator' feature from below.
• Strip HTML Elements by XPATH: Strip HTML elements from final content that match this XPATH. To disable this feature, leave this field blank.
• Strip HTML Elements by Tag Name: Strip HTML elements by their tag name. You can insert more tag names, separated by comma. To disable this feature, leave this field blank.
• Custom Shortcode Creator (from Crawled Content) Custom crawled content shortcode creator. If you wish to crawl multiple content from the imported pages, and use them in feed item content/feed item custom fields/taxonomies, you can configure them from here. Syntax for this field: shortcode_name => [class/id/xpath/regex] @@ [class/id/xpath/regex expression] (to specify multiple shortcodes and crawling values, separate them by a new line. Example: my_custom_shortcode => class @@ post-content. Afterwards, you can use shortcodes in the any settings field that supports shortcodes (ex: 'Generated feed item Content' settings field), like this: %%my_custom_shortcode%%. Official format is %%name_of_custom_shortcode%%
• Banned Words List: Do not include posts that's title or content contains at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Required Words List: Do not include posts that's title or content does not contain at least one of these words. Separate words by comma. To disable this feature, leave this field blank.
• Run Regex On Content: Run regex on post content. To disable this feature, leave this field blank.
• Replace Matches From Regex: Replace the above regex matches with this regex expression. If you want to strip matched content, leave this field blank.
• Strip HTML From Full Content: Do you want to strip HTML from Full Article Content?
• Strip HTML Elements by ID: Strip HTML elements from final content that have this IDs. You can insert more IDs, separeted by comma. To disable this feature, leave this field blank.
• Strip HTML Elements by Class: Strip HTML elements from final content that have this class. You can insert more classes, separeted by comma. To disable this feature, leave this field blank.
• Limit Article Word Count: Set the maximum word count for the article. If you set this value, a "Read More" link will be automatically appended to the end of the article for articles that where shortened. To disable this feature, leave this field blank.
• Automatically Translate Content To: Do you want to automatically translate generated content using Google Translate?
• Source Articles Language: If you use the above translate feature and want to translate not english articles to other languages, please select their original language here.
• Percentage Of The Content To Keep: Select a percentage of the grabbed content that will be included in the article. This is useful when the author states that you can legally get up to 25% of the full article. To disable this feature, leave this field blank.
• Send Cookies With Request: Select the cookie values you want to send with each request. The syntax for this field is the following: cookie_key1=cookie_value1; cookie_key2=cookie_value2 . To disable this feature, leave this field blank.
• Full Content Query Type: Select the query type you want to search for the article full content. XPath: More info/tutorial.
• Content Query String: Input the search query for full content searching. This can be the ID or class name you want to search for, the regex expression you want to apply or the XPath Expression you want to query for. More info/tutorial.
• Lazy Loading Images HTML Tag: Input the correct HTML attribute where the image src is found for lazy loaded images that are scraped from the full content. The attribute containing the actual image URL ex: "data-src" or "data-original"
• Strip HTML from Full Article Content: Do you want to strip HTML from Full Article Content?

Activity and Logging Screen:

• Rules Currently Running: These rules are currently running on your server.
• Restore Plugin Default Settings: Hit this button and the plugin settings will be restored to their default values. Warning! All settings will be lost!
• Activity Log: This is the main log of your plugin. Here will be listed every single instance of the rules you run or are automatically run by schedule jobs (if you enable logging, in the plugin configuration).

How to customize resulting posts with built in shortcodes?

You can use the following shortcodes in post title and content editing:

• %%random_sentence%% - generates a random sentence (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
• %%random_sentence2%% - generates a random sentence (from the second generator) (as you have defined them in plugin config.) More on how to configure the random sentence generator, check plugin documentation (down)
• %%custom_html%% - includes the custom HTML you defined in the Main Settings interface (Custom HTML Code #1:)
• %%custom_html2%% - includes the custom HTML you defined in the Main Settings interface (Custom HTML Code #2:)
• %%item_title%% - includes the item title
• %%item_description%% - includes a short description of the article
• %%item_content%% - includes the item full HTML content
• %%item_content_plain_text%% - includes the items plain text content
• %%item_img_url%% - includes the article's image URL (if it exists)
• %%item_url%% - includes the article's URL
• %%item_cat%% - includes the article's category (if it exists)
• %%item_show_image%% - includes the article's image
• %%item_image_URL%% - includes the article's image URL
• %%item_pub_date%% - includes the article publication date
• %%item_read_more_button%% - adds a read more button pointing to the original content source
• %%royalty_free_image_attribution%% - adds an attribution to the royalty free source
• %%item_screenshot_url%% - adds a screenshot URL of the source page to the feed
• %%item_show_screenshot%% - adds the screenshot of the source page to the feed

How to work with 'Random Sentence Generator'?

You can use the Random Sentence Generator by inserting list of sentences to the 'First List of Possible Sentences (%%random_sentence%%)' text field. Here, you can add full sentences, or sentences with variables. Variables are structured as: %something. A possible list of sentences can be:

• Meet this %adjective %noun %sentence_ending
• This is the %adjective %noun ever%sentence_ending
• I %love_it %nouns , because they are the %adjective %sentence_ending
• My %family says this plugin is very %adjective %sentence_ending
• These %nouns are quite %adjective %sentence_ending

You can define variables in the 'List of Possible Variables:' textfield. Here you can define values to variables, values which will be used in the random sentence forming. Variables can be defined as follows:

variable_name1 => variable_value1;variable_value2;variable_value3

variable_name2 => variable2_value1;variable2_value2;variable2_value3

You can also use variables in variable definition. Example:

noun_with_adjective => %noun;%adjective %noun

An example of variable definition:

adjective_very => %adjective;very %adjective;

adjective => clever;interesting;smart;huge;astonishing;unbelievable;nice;adorable;beautiful;elegant;fancy;glamorous;magnificent;helpful;awesome

noun_with_adjective => %noun;%adjective %noun

noun => plugin;WordPress plugin;item;ingredient;component;constituent;module;add-on;plug-in;addon;extension

nouns => plugins;WordPress plugins;items;ingredients;components;constituents;modules;add-ons;plug-ins;addons;extensions

love_it => love;adore;like;be mad for;be wild about;be nuts about;be crazy about

family => %adjective %family_members;%family_members

family_members => grandpa;brother;sister;mom;dad;grandma

sentence_ending => .;!;!!

These random sentences can be used in post titles or post content, by adding the %%random_sentence%% or %%random_sentence2%% shortcode.

Summary - top

RSS Transmute is a simple, yet powerful tool you can use to create an unlimited number of RSS feeds, from any website from the entire internet. The setup and settings of the plugin couldn't have been easier. Now, let's go and enjoy the results of this great plugin! Have fun using it!

Sources and Credits - top

This component was made by Szabi CodeRevolution, for more information and support contact us at support@coderevolution.ro

Once again, thank you so much for purchasing this item. As I said at the beginning, I'd be glad to help you if you have any questions regarding this plugin and I'll do my best to assist.

CodeRevolution

---