RSS Post Importer - Content Importer Add-on - How to Use
RSS Content Importer Add-on
What is This Add-on
The Content Importer Add-on allows you to fetch full text of items coming from an RSS feed.
For example, even if an RSS feed was not set properly and shows only the excerpt of a blog post, with this add-on you can also capture the full content.
The add-on requires the base plugin RSS Post Importer to work. Both are tightly connected, so if you are not familiar with the base plugin, we recommend checking the following links:
- RSS Post Importer - Getting Started (With Video)
- RSS Post Importer - CreativeMinds Products Documentation
How to Install the Add-on
The process is the same as installing a plugin. Read more: RSS Post Importer - Installation
How to Use The Add-on
When creating or editing a feed, you will notice a few new fields, as highlighted below. They will only appear if the add-on is active.
Content Selector - This field is crucial. You must input on it the CSS element where the content is located. This element likely will be different for each RSS feed.
Part 1: the Content Selector
Access RSS item
Access an RSS item from the feed you would like to use.
An example from the CreativeMinds blog: https://www.cminds.com/ultimate-guide-for-adding-https-to-wordpress/
Inspect the Element
You must find the element which contains the content.
To do so, click on it with the right button and choose inspect - selecting the beginning of the content is better. This works in both Chrome and Firefox.
You can confirm you have found the element when the relevant area is highlighted.
Isolate class or id
In this case, the element is inside <div class= "articleContent entry-content" itemprop="articleBody">.
The most relevant CSS elements are id and class.
So, in this case, we can use either articleContent or entry-content, as both are classes. They will produce the same effect.
Part 2: Adding CSS element to the feed page
Now that we found the element, it's time to add it to the feed page. Head back to the Content Selector fields.
- Auto search and detect content - You can use this if, even doing the process above, the selector is not working. Enabling this option turns off the Content Selector option below
- Content Selector - Include the element to be included. In this example above, .articleContent
- Selector to exclude - Write down one or more elements that should be avoided. This is useful to remove extra advertisement injections. Note: you can enter a few selectors, and they must be separated by comma.
First two options are mutually exclusive. Once Auto search is unchecked, plugin will search selector value from second option among target page content. If Autosearch is enabled, content selector will be ignored during content extraction.
TIP: Class vs. IDEach element needs a symbol preceding it.
- class - . (final dot). Example: .articleContent (if class="articleContent")
- id - # (number sign/hash). Example: #articleContent (if id="articleContent")
Selector Examples Table
|Document has||You should include in the add-on|
More information: CSS selectors - CSS: Cascading Style Sheets
Note on Images
By default, the add-on saves images to the Media Library.
You can change this by unchecking the option "Don't save images from the full content to the Media Library".
Only change the setting if you understand what you are doing, as some site owners disable hotlinking of images.
Now the add-on will collect the element you have selected.
Pausing the Capture
Check the option "Pause Full content extraction" to interrupt it for that feed alone.
Note that feed items will still be imported but without the full content extraction rule.