Jump to content

Installation for Worthy News Syndication Module within the Worthy Ministries Suite WORDPRESS Plugin


George

Recommended Posts

Worthy News Syndication Plugin Instructions

How to configure the plugin

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

worthy-suite-settings-dashboard.jpg.0beb03f8e2aac04f2fe47a5c4d4f57ec.jpg

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

571f8835-ab16-4e74-82a2-7293096c485e.thumb.jpeg.84987d915fb45a66c23bcccde754ec1d.jpeg

Once activated, Click on Worthy Suite again … and you should see how to set up your Worthy News Syndication feed.

Click on Worthy Suite > News Settings on the left hand side.

news-settings.jpg.d533f5c529b0ca34a149682dccac4d49.jpg

You can choose which categories of stories which you wish to import.  You have the option of gathering World, US, Israel and Christian stories from Worthy News.  You also have the option of downloading images to insert into your pages as well.

1671427025_Screenshot2020-05-2110_22_12.png.c9717e2e86837429b4a22d1148dc9d9a.png

Be sure to SAVE changes to record your settings!

You can always import ALL the stories … and choose to limit which stories you wish to run on any page you wish to run Worthy News articles.

It MAY take some time to import your first set of news articles.  Perhaps up to an hour depending on the time you set up your plugin.

Each hour, your WordPress will automatically retrieve stories we have created on Worthy News. 

After your first import of stories, you should see the Worthy Plugins > News Items populated with the last 50 stories we have run on Worthy News.  Once your plugin is running, your site will AUTOMATICALLY add Worthy News Content as we report Monday through Friday. 

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 Headline … click Hide.

hide-worthy-news.jpg.be466e8d13c9c655019ab48b63a4e314.jpg

How to DISPLAY Worthy News on your site

FIRST STEP to DISPLAY Worthy News

BE SURE TO CREATE THE TEMPLATE PAGES YOU WISH TO DISPLAY WORTHY NEWS 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 News stories.

Go to PAGES > ADD NEW 

pages-add-new.jpg.c65b230eacdbbf9e49be3176ce61c0d0.jpg

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

edit-url.thumb.jpg.6d460bb830aac7ee8c23e362cd1214f5.jpg

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

worthy-news-edit-url.thumb.jpg.91b9379e3b6c20da599180540af65a0e.jpg

If you wanted to separate your pages to create a World News Page only … you may want to create a special page such as World News and create the PERMALINK — /world-news/

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

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

[worthy_plugins_news_story_title]

Page-Code.thumb.jpg.34139dc890222b65913753c6d08c2bdb.jpg

Within the BODY create a DIV class (this will allow you full control of CSS and the output of your site) and the story tag.  (See example above)

<div class="details">[worthy_plugins_news_story_body]</div>

SECOND STEP to DISPLAY Worthy News

The Worthy News Syndication plugin is VERY customizable and can be easily configured for your site!

The Worthy News Syndication plugin utilizes WordPress ShortCodes so that as the developer of your ministry, you have complete control of how you wish Worthy News to display on your site.

OPTIONS YOU CAN USE WHEN DISPLAYING WORTHY NEWS

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”.

THE BASE SHORT CODE IS: 

[worthy_plugins_news_stories detail_page_uri="/worthy-news/"]

Display-News-Code.thumb.jpg.22c2512b8b10bf63ce74960a8784ab28.jpg

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-news/ to display all of our Worthy News articles.  So the BASE SHORT CODE would be 

[worthy_plugins_news_stories detail_page_uri="/worthy-news/"]

This will display the list of stories on your post, page, or widget that is in your database that was gathered by the Worthy News 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 LIMIT WORTHY NEW SYNDICATION PLUGIN TO A SINGLE OR MULTIPLE CATEGORIES

DEFAULT is to display all categories you have selected in the in the SETTINGS PAGE.  To see what categories you have selected to import go to WORTHY SUITE > NEWS SETTINGS.

If you wish to LIMIT the output to certain categories, simple choose which categories you wish to display.   The options are available, “world, us, Israel, christian”.  You can use more than one category if you wish when creating your shortcode.   

Let’s say you want to create a page that displays only World News add this short code to display only categories=“world” stories.

Example short code would be — 

[worthy_plugins_news_stories detail_page_uri="/world-news/" categories="world"]

So in our example, we created a “world-news” page in the example above and we connected all stories within the World category to display on the TEMPLATE page we “world-news”.

Now this would display the “World Stories” only — and display the stories onto the “world-news” page.  

HOW TO SHOW EXCERPTS ON YOUR HEADLINES PAGE

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_news_stories detail_page_uri="/worthy-news/" 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_news_stories detail_page_uri="/worthy-news/" limit=10]

This shortcake would display the last 10 Worthy News stories and display the full text of the articles on the “worthy-news” 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_news_stories detail_page_uri="/world-news/" categories="world" excerpts=true limit=10]

This short code example would display on the PAGE - “world-news” only the category world news, display the excerpts from the article and limit the display to 10 articles.

[worthy_plugins_news_stories detail_page_uri="/news/" categories="world,us,israel" excerpts=true limit=15]

This short code example would display on the TEMPLATE PAGE - “news” the categories World, US, and Israel news along with the excerpts and limiting the number of stories to last 15 articles in those three categories.

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_news_stories detail_page_uri="/worthy-news/" excerpts=true limit=10 pager=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_news_story
  • worthy_news_story_body
  • worthy_news_story_excerpt
  • worthy_news_story_title

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_news_story_title { font-size:18px; font-weight:600; }

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

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

categories-to-run.jpg

Screenshot 2020-05-21 10.22.12.png

Link to comment
Share on other sites

  • George changed the title to Installation for Worthy News Syndication Module within the Worthy Ministries Suite WORDPRESS Plugin
  • George pinned this topic
  • 1 month later...

IF you want to ADD IMAGES to the posts ...

<img src="[worthy_plugins_news_story_image name=sm_medium]" alt="" />

The sizes you can use are ... thumbnail, medium, large, sm_medium and front_thumb.  You also have the ability to decide to float it to the left or the right.

For example on the story page if you wanted to add an image and float it to the right ...

<div style="text-align:right; padding:0px 0px 10px 15px; float:right; width:300px;"><img src="[worthy_plugins_news_story_image name=sm_medium]" alt="" /></div>

Please let us know if you need any help adding images to your stories!

Link to comment
Share on other sites

You can also add images to your headlines as well.  This is an example with multiple settings in use ---

[worthy_plugins_news_stories detail_page_uri="/worthy-news/" excerpts=true limit=10 pager=true image=thumbnail image_position=left]

 

 

Link to comment
Share on other sites

  • 7 months later...

Trouble installing! I have done everything required including entering the API key but get a warning when I go to the news settings The instructions show a list of boxes to check but the only box to check is to download images. This is in the place where the boxes should be: Warning: count(): Parameter must be an array or an object that implements Countable in /wp-content/plugins/worthy-suite/views/news-settings.php on line 18 It also shows that I need an API key before you can continue which I have already done. Using WP version 5.6. What is the solution? The PHP code through line 18 follows:

1  <?php
2  /**
3  * Plugin Name: Worthy Suite
4  * Plugin URI: https://worthyplugins.com/worthy-suite
5  * Description: Worthy Suite provides an easy gateway into the various plugins of Worthy Ministries
6  * Version: 0.3.8
7  * Requires at least: 3.1.0
8  * Tested up to: 5.4
9  * Author: Worthy Plugins
10 */

11

12 namespace WorthyPlugins\Suite;

13

14 if ( ! defined( 'ABSPATH' ) ) {
15    return;
16 }

17

18 /**

Link to comment
Share on other sites

  • 1 year later...

Shalom Brotherbell,

I just tried to send you an email, however, it bounced.

I've gone ahead and tested the plugin on the latest version it appears to be up-to-date.  Please feel free to contact us and we'll try to isolate the issue on your end.

Be blessed,

George

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...