Rayos Article Ingestion uses Blox syndication to pull content from other sources, such as sister sites, AP, or the TownNews Content Exchange, into your site. Articles can be ingested manually, in bulk, or automatically using criteria you set.
Ingested Articles is broken out into 3 sections:
To start ingesting articles, you’ll need to utilize the Syndication Center.
All Ingested Articles
Articles that have been ingested from all your syndication channels are available to view and update by going to Ingested Articles > All Ingested Articles in the left side menu. You can search for a specific article by using the search bar and filters across the top of the article list, which include your configured automations and channels set up via the Syndication Center.
Editing Ingested Articles
To edit an article, click on the Title or hover over the title for the Edit options. Once you are editing an ingested article, you have the following options:
- Publish – You can changed the article status or move the article to the trash.
- Categories – Add or remove categories that have been set during the article ingestion.
- Featured Image – Assign or change the articles featured image.
- Rayos Alert – Quick Send – You can send a breaking news alert from an ingested article following the same procedures and a standard article.
- Content Wrapper – Ingested articles will utilized your default content wrapper, but that can be updated per each individual article.
By default, the title, subtitle, excerpt, author, & body of an ingested article can not be updated. Those fields will be grayed out. If you need to edit any of these fields, there is an “Enable post editing?” link at the top of the article. Note that by editing an ingested article you will break its connection to the importer and the article will no longer be eligible for updates from the original source. Any updates will need to be made manually.
Automated article ingestions that have been configured via the Syndication Center can be found under Ingested Articles > Saved Automations. The list of automations will display the title of the automation, whether it is currently active, the source channel, and the category that is being automatically assigned to the articles.
Editing a Saved Automaton
You can edit some of the fields for your saved automations. To edit an automation, click on the Title or hover over the title for the Edit options. Once you are editing an automation, you have the following options:
- Automation Switch – Toggle the automation from “Active” to “Inactive” to turn off the automatic content import.
- Default Image – You can assign or change the default Featured Image to the ingested articles for articles that come in from the source without one assigned. Upload that image here by clicking Add Image.
- Automatic Priority Level – This is the frequency with with the automation will run. All automations default to “Normal.” Setting a saved automation’s priority to “High” means that this automation will run before any other automations.
WARNING: Selecting a “High” priority on automations that ingest more that 25 articles a day or selecting a “High” priority on over 5 automations total can lead to greater than expected processing times for high priority syndicated content and a failure of “Normal” or “Low” priority automations.
If you have questions about using the setting, please contact TownNews support before making changes.
- Automaton Alerts – Use this to automatically trigger alerts from this automation. You can set the Alert Style to be used. The alerts will utilize your default alert channels and settings found under Alerts > Settings.
The search criteria used to create the automation cannot be edited. You can see the settings when editing an automation under the Automation Settings section. To make a change to the search, a new automation will need to be created via the Syndication Center with the new search criteria.
The Syndication Center is where you can ingest articles into your site from your available channels. From here, you can search for content, manually ingest articles or set up Saved Automations from searches to automatically ingest and publish articles.
At the top of the Syndication Center is the search. Use the Channel drop down to select from your available channels. Typical channels include content sharing for sister sites, the TownNews Content Exchange, the Digital Content Center, CNN or AP.
Depending on the channel you select, you will see different available search controls. Here are some of the typical controls:
- Search Text – Use this text field to find content that uses specific terms.
- Slug – This is the relative URL of the article. For example, the slug of this article is “ingested-articles” which you can find in your browser’s address bar.
- Category – The category (or Section in Blox) that the article has been tagged with. This is a good way to filter down by a specific type of content. Note that the categories will sort alphabetically, with some channels that utilize sub-categories showing indented under the parent category.
- Flag – Certain Blox channels use a “flag” to identify specific types of content on the site. Those flags include things like “Featured,” “Sponsored,” or “Breaking.”
- Start Date – This is the date the article was published. Use the date picker to narrow down articles published during a specific time period.
Once your search is set, click the Refine Search button to run it. Your matching content will appear below under Blox Objects, with the latest article appearing first.
Importing Articles (Manual)
If you find articles you want to ingest onto your site, check the box on the left side of each of the articles. When ready, click Import Selected Items. This will bring up the Syndication Import window with the following options:
- Category – You can select one Rayos category to automatically assign to the imported article(s). Additional categories can be added by manually editing the article under Ingested Articles > All Ingested Articles.
- Featured Image – You can assign a default Featured Image to the article(s) if one is not provided by the source. Upload that image here by clicking Add Image.
- Publish or Draft – By default, the ingested articles will come in with a Published status. Click the switch to import the articles in a Draft status.
When ready, click Ingest Content to import the articles into your site. At the bottom of the window, you will see a list of your selected articles and their import status. Click the X in the top right to close the window when finished. Navigate to Ingested Articles > All Ingested Articles to view or edit the article.
If there is a set of articles that you are able to configure a search for that you want to automatically import into your site on an ongoing basis, you can utilize the Automation feature of the Syndication Center. Once your search criteria are set and under the Channel Search Controls (see Syndication Search section above), click the Create Automation button. This will bring up the Create Automation window with the following options:
- Automation Title – This is the name automation you will see on the backend of the site. Make sure you title it something descriptive so you can tell what content is being imported.
- Category – You can select one Rayos category to automatically assign to the imported articles. Additional categories can be added once the article has been ingested by manually editing the article under Ingested Articles > All Ingested Articles.
- Initial Status – This is the status of the automation. By default, the automation will be set to “Active” which means the articles will start ingesting immediately. Click the switch to set the automation to “Inactive.” This can be updated later under Ingested Articles > Saved Automations.
- Default Image – You can assign a default Featured Image to the ingested articles for articles that come in from the source without one assigned. Upload that image here by clicking Add Image.
When ready, click Save Automation. After a few minutes, active automations will start importing content into your site. You can find the articles under Ingested Articles > All Ingested Articles or you can edit the automations under Ingested Articles > Saved Automations.
Frequently Asked Questions
How does the Byline work on ingested articles? It does not appear to use the assigned Author.
Rayos Syndication has built-in functionality that passes the original byline through as metadata to be displayed on the frontend of your site. The admin author must remain Rayos Syndication User for this functionality to work appropriately. It cannot be changed. If you try to edit the Author field on the article, it will break the article’s connection with the original source and no longer receive updates, nor will it display the original author.