Installation Instructions for Worthy Devotions WORDPRESS PLUGIN

[George]

Worthy Devotions Syndication Plugin Instructions

How to configure the plugin

Click on Worthy Suite > Dashboard -- click on Dashboard.

Click on Worthy Suite > Dashboard > Install Worthy Devotions Syndication Plugin

After installing Worthy Devotions, you should now see on the Worthy Suite > Devotions link a populated list of the latest devotions from Worthy Ministries.

Each hour, your WordPress will automatically retrieve devotions we have created on Worthy Devotions.   We update our devotions Monday through Friday around 3-4 AM EST.

You have the option of “HIDE” any story you do not wish to run on your site by going to Worthy Suite > News Stories.  Simply hover over the Devotion … click Hide.

How to DISPLAY Worthy Devotions on your site

FIRST STEP to DISPLAY Worthy Devotions

BE SURE TO CREATE THE TEMPLATE PAGES YOU WISH TO DISPLAY WORTHY DEVOTIONS FIRST, AS THIS IS CRUCIAL TO GIVING THE PLUGIN THE NECESSARY LOCATION TO OUTPUT THE NEWS STORIES YOU HAVE IN YOUR DATABASE.

BEGIN with creating a TEMPLATE PAGE to POST your Worthy Devotions.

Go to PAGES > ADD NEW 

Once you create the page — be sure to EDIT your PERMALINK to reflect what you wish to display on your site. 

For example, if you wish to create a PAGE to DISPLAY all Worthy Devotions, you might want to create a PERMALINK within the page you created to display Worthy devotions. — /worthy-devotions/

If you wish to have Worthy Devotions AUTO-POPULATE your Title place this tag in your TEMPLATE PAGE.

[worthy_plugins_devotion_single_title]

Then ADD the code to the BODY to display the Worthy Devotion.

[worthy_plugins_devotion_single_body]

OPTIONS YOU CAN USE WHEN DISPLAYING WORTHY DEVOTIONS

The short codes can be configured to run on a “page”, on a “post” or as a “widget’.”

We have the following different configuration options that can be configured in your shortcodes.

You can create as many short codes as you wish and place them as you wish as “posts, pages, or widgets”.

You need to add the PAGE URI.  This is the page to which the short code is to OUTPUT the information from the database to your page.  For example, we created a page, /worthy-devotions/ to display all of our Worthy Devotions articles.  So the BASE SHORT CODE would be 

[worthy_plugins_devotion_list detail_page_uri="/worthy-devotions/"]

This will display the list of devotions on your post, page, or widget that is in your database that was gathered by the Worthy Devotions Syndication plugin and also tell the plugin to which page to output the information from your database.  You can create any VARIABLE you wish in the PAGE URI as long as it connects to the PAGE you CREATED in STEP ONE.

These are the different options that can be configured.

HOW TO SHOW EXCERPTS

By DEFAULT, excerpts are not displayed.  However, if you wanted to show an excerpt from the news headlines, it’s easy to do.

Excerpts=true

So the shortcake for showing excerpts added to the BASE SHORT CODE is fairly simple.

[worthy_plugins_devotion_list detail_page_uri="/worthy-devotions/" excerpts=true]

HOW TO CHANGE THE NUMBER OF STORIES TO DISPLAY

By DEFAULT, the plugin displays 20 stories.

To change the number of stories to display simply add the tag to your short code  limit= number of stories to run

Example

[worthy_plugins_devotion_list detail_page_uri="/worthy-devotions/" limit=5]

This shortcake would display the last 10 Worthy News stories and display the full text of the articles on the “worthy-devotions” page.

So in short you can customize your output to fit your needs and use a combination of all the settings within your short code.  

SOME EXAMPLES OF USE

[worthy_plugins_devotion_list detail_page_uri="/worthy-devotions/" limit=5 excerpts=true]

ADD PAGINATION TO YOUR STORIES

By Default, PAGINATION is not activated.  If you wish to add an archive so that every story you have imported is able to be searched, simply add to your tag the PAGER tag. 

[worthy_plugins_devotion_list detail_page_uri="/worthy-devotions/" limit=5 pager=true excerpts=true]

HOW TO CUSTOMIZE THE LOOK OF THE OUTPUT

We have included tags within the OUTPUT so that you can customize through CSS the look of the news on your site.

worthy_plugins_devotion_list - List page, has limit, excerpts, etc.
worthy_plugins_devotion_single - Shows the title/body
worthy_plugins_devotion_single_title - Shows just the title
worthy_plugins_devotion_single_body - Shows just the body

Simply add to your CUSTOM CSS file a style to whatever strings the output is connected.

For example, let’s say we wanted to configure the title output.

.worthy_plugins_devotions_single_title { font-size:18px; font-weight:600; }

This would create a 18 pixel bolded font when displaying the Worthy Devotions article title.

Using CSS classes, you have complete control of how it displays on your site.