Documentation

WP News and Scrolling Widgets Pro

Getting started with WP News and Scrolling Widgets Pro

WP News and Scrolling Widgets Pro adds a Menu tab in WP Admin side with the name “News Pro” where you can add new News post, edit and delete. You can also add categories for News.

news-pro-all

Bellow screen shows how to add a News post. You just click on “Add News” and insert News title and contents as you add for WordPress post.
add-news

How to display and shortcodes

Display a News page is very simple. Just go to Pages > Add New and add page title ie Our News and add below shortcode as per your need.

WP News and Scrolling Widgets Pro contains 6 shortcodes
[sp_news] – News Grid
[sp_news_slider] – News Slider
[wpnw_gridbox] – News Grid Box
[wpnw_gridbox_slider] – News Grid Box Slider
[wpnw_news_list] – News List
[wpnw_news_ticker] – News Ticker

Note: Please make sure that Permalink link should not be “/news” Otherwise all your news will go to archive page. You can give it other name like “/ournews, /latestnews etc”

News Grid Shortcode Parameters

[sp_news]

  • Limit
    [sp_news limit="15"]
    Display number of posts. You can see all post by limit=”-1″.

  • Category
    [sp_news category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [sp_news include_cat_child="true"]
    Display child category. Values are “true” and “false”.

  • Category Name
    [sp_news category_name="Sports"]
    Display News category name.

  • Design
    [sp_news design="design-1"]
    Select design for News. Designs are design-1 to design-50.

  • Grid / Cloumn
    [sp_news grid="1"]
    Display News in a column/grid on your website. Values are 1,2,3 and 4.

  • Media Size
    [sp_news media_size="large"]
    Select image size for Display. Option are “full, large, medium OR thumbnail”

  • Image Fit
    [sp_news image_fit="true"]
    Set image fit to box. By default value is “true”. Option are “true OR false”.

  • Pagination
    [sp_news pagination="true"]
    Show/Hide pagination links. By default value is “true”. Values are “true” and “false”

  • Pagination Type
    [sp_news pagination_type="numeric"]
    Pagination type works when pagination set to true.Two types can be used for pagination “Numeric” and “Previous-next”

  • Show Date
    [sp_news show_date="true"]
    Display news date OR not. By default value is “true”. Options are “true OR false”

  • Show Category Name
    [sp_news show_category_name="true"]
    Display News Post category name OR not. By default value is “true”. Options are “true OR false”

  • Show Content
    [sp_news show_content="true"]
    Display News Post Short content OR not. By default value is “true”. Options are “true OR false”

  • Show Full Content
    [sp_news show_full_content="false"]
    Display Full News content on main page if you do not want word limit. By default value is “false” .

  • Show Read More
    [sp_news show_read_more="true"]
    Show/Hide read more links. By default value is “true”. Values are “true” and “false” .

  • Change Read More button Text
    [sp_news read_more_text="View More"]
    Change ‘Read More’ button text to your desired text.

  • Content Words Limit
    [sp_news content_words_limit="20"]
    Control News post short content words limit. By default limit is 20 words.

  • For Continue Reading
    [sp_news content_tail="..."]
    Display dots after the news content for continue reading .

  • Order
    [sp_news order="DESC"]
    Set News post order. Values are “ASC” OR “DESC”.

  • Orderby
    [sp_news orderby="date"]
    Set orderby for news. You can set “date” (News Published Date), “Modified” (News updated date), “Title” (News title), “Rand” (Random), “Menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [sp_news link_target="self"]
    Open link in same window OR in new tab .Values are “self ” OR “blank” .

  • Display Posts
    [sp_news posts="40"]
    Display specific News Posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [sp_news exclude_post="40"]
    Exclude some News post which you do not want to display.

  • Exclude Category
    [sp_news exclude_cat="25"]
    Exclude News category which you do not want to display. You can pass multiple category ids by comma separated.

  • Image Height
    [sp_news image_height="400"]
    You can set news post images height.

  • Query Offset
    [sp_news query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.
    Note: Do not use with pagination and limit parameter.

News Slider Shortcode Parameters

[sp_news_slider]

  • Limit
    [sp_news_slider limit="15"]
    Display latest 15 News post and then pagination.

  • Category
    [sp_news_slider category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [sp_news_slider include_cat_child="true"]
    Display child category or not. Values are “true” and “false”.

  • Category Name
    [sp_news_slider category_name="Sports"]
    Display news category name.

  • Design
    [sp_news_slider design="design-1"]
    Select design for News. Designs are design-1 to design-45.

  • Show Date
    [sp_news_slider show_date="true"]
    Display News date OR not. By default value is “True”. Options are “true OR false”

  • Image Size
    [sp_news_slider media_size="large"]
    Set image size for display. Values are “full. large, medium OR thumbnail”

  • Image Fit
    [sp_news_slider image_fit="true"]
    Set image fit to box. By default value is “true”. Options are “true OR false”

  • Show Category Name
    [sp_news_slider show_category_name="true"]
    Display News post category name OR not. By default value is “true”. Options are “true OR false”

  • Show Content
    [sp_news_slider show_content="true"]
    Display News post short content OR not. By default value is “true”. Options are “true OR false”

  • Show Read More
    [sp_news_slider show_read_more="true"]
    Show/Hide read more links. By default value is “true”. Values are “true” and “false” .

  • Change Read More Text
    [sp_news_slider read_more_text="View More"]
    Change ‘Read More’ button text to your desired text.

  • Content Words Limit
    [sp_news_slider content_words_limit="20"]
    Control news post short content Words limit. By default limit is 20 words.

  • For Continue Reading
    [sp_news_slider content_tail="..."]
    Display dots after the news content for continue reading .

  • Slides Column
    [sp_news_slider slides_column="3"]
    Display number of News post at a time in slider.

  • Slides Scroll
    [sp_news_slider slides_scroll="1"]
    Scroll number of news post at a time.

  • Dots
    [sp_news_slider dots="true"]
    Display slider navigation dots. Values are “true” and “false” .

  • Arrows
    [sp_news_slider arrows="true"]
    Display slider navigation arrows.Values are “true” and “false” .

  • Autoplay
    [sp_news_slider autoplay="true"]
    Enable slider autoplay. Values are “true” and “false”.

  • Autoplay Interval
    [sp_news_slider autoplay_interval="2000"]
    Set slider slide interval time.

  • Speed
    [sp_news_slider speed="2000"]
    Set slider speed .

  • Loop
    [sp_news_slider loop="true"]
    Enable continuous sliding. Values are “true” OR “false”.

  • RTL
    [sp_news_slider rtl="true"]
    Enable RTL for slider. Values are “true” OR “false”.

  • Order
    [sp_news_slider order="DESC"]
    Set news post order. Values are “ASC” OR “DESC”.

  • Orderby
    [sp_news_slider orderby="date"]
    Set orderby for news. You can set “date” (News Published Date), “modified” (News Updated Date), “title” (News Title), “rand” (Random), “menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [sp_news_slider link_target="self"]
    Open link in same window OR in new tab . Values are “self ” OR “Blank” .

  • Display Posts
    [sp_news_slider posts="40"]
    Display specific News posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [sp_news_slider exclude_post="40"]
    Exclude some News Post which you do not want to display.

  • Exclude Category
    [sp_news_slider exclude_cat="25"]
    Don’t show post of only specific category. You can pass multiple category ids by comma separated.

  • Image Height
    [sp_news_slider image_height="400"]
    You can set News post images height.

  • Query Offset
    [sp_news_slider query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.

News Grid Box Shortcode Parameters

[wpnw_gridbox]

  • Limit
    [wpnw_gridbox limit="6"]
    Display number of posts

  • Category
    [wpnw_gridbox category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [wpnw_gridbox include_cat_child="true"]
    Display child category.Values are “true” and “false”.

  • Category Name
    [wpnw_gridbox category_name="Sports"]
    Display News category name.

  • Design
    [wpnw_gridbox design="design-1"]
    Select design for News. Designs are design-1 to design-13.

  • Image fit
    [wpnw_gridbox image_fit="false"]
    Show image in box size. Values are “true” and “false”

  • Pagination
    [wpnw_gridbox pagination="true"]
    Show/Hide pagination links. By default value is “true”. Values are “true” and “false”

  • Pagination Type
    [wpnw_gridbox pagination_type="numeric"]
    Pagination type works when pagination set to true.Two types can be used for pagination “Numeric” and “Previous-next”

  • Show Date
    [wpnw_gridbox show_date="true"]
    Display news date OR not. By default value is “true”. Options are “true OR false”

  • Show Category Name
    [wpnw_gridbox show_category_name="true"]
    Display News Post category name OR not. By default value is “true”. Options are “true OR false”

  • Show Content
    [wpnw_gridbox show_content="true"]
    Display News Post Short content OR not. By default value is “true”. Options are “true OR false”

  • Show Read More
    [wpnw_gridbox show_read_more="true"]
    Show/Hide read more links. By default value is “true”. Values are “true” and “false” .

  • Change Read More Text
    [wpnw_gridbox read_more_text="View More"]
    Change ‘Read More’ button text to your desired text.

  • Content Words Limit
    [wpnw_gridbox content_words_limit="20"]
    Control News post short content words limit. By default limit is 20 words.

  • Continue Reading
    [wpnw_gridbox content_tail="..."]
    Display dots after the news content for continue reading .

  • Order
    [wpnw_gridbox order="DESC"]
    Set News post order. Values are “ASC” OR “DESC”.

  • Orderby
    [wpnw_gridbox orderby="date"]
    Set orderby for news. You can set “date” (News Published Date), “Modified” (News updated date), “Title” (News title), “Rand” (Random), “Menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [wpnw_gridbox link_target="self"]
    Open link in same window OR in new tab .Values are “self ” OR “Blank” .

  • Display Posts
    [wpnw_gridbox posts="40"]
    Display specific News Posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [wpnw_gridbox exclude_post="40"]
    Exclude some News post which you do not want to display.

  • Exclude Category
    [wpnw_gridbox exclude_cat="25"]
    Exclude category which you do not want to display. You can pass multiple category ids by comma separated.

  • Image Height
    [wpnw_gridbox image_height="400"]
    You can set news post images height.

  • Query Offset
    [wpnw_gridbox query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.

    Note: Do not use with pagination and limit parameter.

News Grid Box Slider Shortcode Parameters

[wpnw_gridbox_slider]

  • Limit
    [wpnw_gridbox_slider limit="15"]
    Display latest 15 News post and then pagination.

  • Category
    [wpnw_gridbox_slider category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [wpnw_gridbox_slider include_cat_child="true"]
    Display child category.Values are “true” and “false”.

  • Category Name
    [wpnw_gridbox_slider category_name="Sports"]
    Display news category name.

  • Design
    [wpnw_gridbox_slider design="design-1"]
    Select design for News. Designs are design-1 to design-8.

  • Image fit
    [wpnw_gridbox_slider image_fit="true"]
    Show image in box size. Values are “true” and “false”

  • Show Date
    [wpnw_gridbox_slider show_date="true"]
    Display News date OR not. By default value is “true”. Options are “true OR false”

  • Show Category Name
    [wpnw_gridbox_slider show_category_name="true"]
    Display News post category name OR not. By default value is “true”. Options are “true OR false”

  • Show Content
    [wpnw_gridbox_slider show_content="true"]
    Display News post short content OR not. By default value is “true”. Options are “true OR false”

  • Show Read More
    [wpnw_gridbox_slider show_read_more="true"]Show/Hide read more links. By default value is “true”. Values are “true” and “false” .

  • Change Read More Text
    [wpnw_gridbox_slider read_more_text="View More"]
    Change ‘Read More’ button text to your desired text.

  • Content Words Limit
    [wpnw_gridbox_slider content_words_limit="20"]
    Control news post short content Words limit. By default limit is 20 words.

  • Continue Reading
    [wpnw_gridbox_slider content_tail="..."]
    Display dots after the news content for continue reading .

  • Dots
    [wpnw_gridbox_slider dots="true"]
    Display slider navigation dots. Values are “true” and “false” .

  • Arrows
    [wpnw_gridbox_slider arrows="true"]
    Display slider navigation arrows.Values are “true” and “false” .

  • Autoplay
    [wpnw_gridbox_slider autoplay="true"]
    Enable slider autoplay. Values are “true” and “false”.

  • Autoplay Interval
    [wpnw_gridbox_slider autoplay_interval="2000"]
    Set slider slide interval time.

  • Speed
    [wpnw_gridbox_slider speed="300"]
    Set slider speed .

  • Loop
    [wpnw_gridbox_slider loop="false"]
    Enable continuous sliding. Values are “true” OR “false”.

  • Order
    [wpnw_gridbox_slider order="DESC"]
    Set news post order. Values are “ASC” OR “DESC”.

  • Orderby
    [wpnw_gridbox_slider orderby="date"]
    Set orderby for news. You can set “date” (News Published Date), “modified” (News Updated Date), “title” (News Title), “rand” (Random), “menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [wpnw_gridbox_slider link_target="blank"]
    Open link in same window OR in new tab . Values are “self ” OR “Blank” .

  • Display Posts
    [wpnw_gridbox_slider posts="40"]
    Display specific News posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [wpnw_gridbox_slider exclude_post="40"]
    Exclude some News Post which you do not want to display.

  • Exclude Category
    [wpnw_gridbox_slider exclude_cat="25"]
    Exclude category which you don’t want to display. You can pass multiple category ids by comma separated.

  • Image Height
    [wpnw_gridbox_slider image_height="400"]
    You can set News post images height.
  • Query Offset
    [wpnw_gridbox_slider query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.

  • RTL
    [wpnw_gridbox_slider rtl=""]
    Enable RTL. Values are “true OR false”

News List Shortcode Parameters

[wpnw_news_list]

  • Limit
    [wpnw_news_list limit="15"]
    Display latest 15 news of posts then pagination.

  • Category
    [wpnw_news_list category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [wpnw_news_list include_cat_child="true"]
    Display child category.Values are “true” and “false”.

  • Category Name
    [wpnw_news_list category_name="Sports"]
    Display News category name.

  • Design
    [wpnw_news_list design="design-1"]
    Select design for News. Designs are design-1 to design-8.

  • Media Size
    [wpnw_news_list media_size="large"]
    Select image size for display. Size are “full”, “medium”, “large” or “thumbnail”.

  • Image fit
    [wpnw_news_list image_fit="true"]
    Show image in box size. Values are “true” and “false”

  • Pagination
    [wpnw_news_list pagination="true"]
    Show/Hide pagination links. By default value is “true”. Values are “true” and “false”

  • Pagination Type
    [wpnw_news_list pagination_type="numeric"]
    Pagination type works when pagination set to true. Two types can be used for pagination “numeric” and “Previous-next”

  • Show Date
    [wpnw_news_list show_date="true"]
    Display news date OR not. By default value is “true”. Options are “true OR false”

  • Show Category Name
    [wpnw_news_list show_category_name="true"]
    Display News Post category name OR not. By default value is “true”. Options are “true OR false”

  • Show Content
    [wpnw_news_list show_content="true"]
    Display News Post Short content OR not. By default value is “true”. Options are “true OR false”

  • Show Full Content
    [wpnw_news_list show_full_content="false"]
    Display News Post Short content OR not. By default value is “false”. Options are “true OR false”

  • Show Read More
    [wpnw_news_list show_read_more="true"]
    Show/Hide read more links. By default value is “true”. Values are “true” and “false” .

  • Change Read More Text
    [wpnw_news_list read_more_text="View More"]
    Change ‘Read More’ button text to your desired text.

  • Content Words Limit
    [wpnw_news_list content_words_limit="20"]
    Control News post short content words limit. By default limit is 20 words.

  • Continue Reading
    [wpnw_news_list content_tail="..."]
    Display dots after the news content for continue reading .

  • Order
    [wpnw_news_list order="DESC"]
    Set News post order. Values are “ASC” OR “DESC”.

  • Orderby
    [wpnw_news_list orderby="date"]
    Set orderby for news. You can set “date” (News Published Date), “Modified” (News updated date), “Title” (News title), “Rand” (Random), “Menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [wpnw_news_list link_target="self"]
    Open link in same window OR in new tab .Values are “self ” OR “Blank” .

  • Display Posts
    [wpnw_news_list posts="40"]
    Display specific News Posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [wpnw_news_list exclude_post="40"]
    Exclude some News post which you do not want to display.

  • Exclude Category
    [wpnw_news_list exclude_cat="25"]
    Exclude category which you don’t want to display. You can pass multiple category ids by comma separated.

  • Image Height
    [wpnw_news_list image_height="400"]
    You can set news post images height.

  • Query Offset
    [wpnw_news_list query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.

    Note: Do not use with pagination and limit parameter.

News Ticker Shortcode parameters

[wpnw_news_ticker]

  • Limit
    [wpnw_news_ticker limit="20"]
    Display latest 20 News post in ticker.

  • Ticker Title
    [wpnw_news_ticker ticker_title="Latest News"]
    Set your desire ticker title.
  • Theme Color
    [wpnw_news_ticker theme_color="#2096cd"]
    Set your desire theme color.

  • Heading Font Color
    [wpnw_news_ticker heading_font_color="#fff"]
    Set Heading font color.

  • Font Color
    [wpnw_news_ticker font_color="#2096cd"]
    Set ticker font color.

  • Font Style
    [wpnw_news_ticker font_style="normal"]
    Set ticker font style.

  • Ticker Effect
    [wpnw_news_ticker ticker_effect="fade"]
    Set ticker effect by this parameter. Option are “slide-h, slide-v OR fade”

  • Autoplay
    [wpnw_news_ticker autoplay="true"]
    Enable slider autoplay. Values are “true” and “false”.

  • Speed
    [wpnw_news_ticker speed="3000"]
    Set slider Speed .

  • Category
    [wpnw_news_ticker category="40"]
    Display News post categories wise.You can enter multiple category id with comma separated.

  • Include Category child
    [wpnw_news_ticker include_cat_child="true"]
    Display Child category. Values are “true” and “false”.

  • Order
    [wpnw_news_ticker order="DESC"]
    Set News Post Order. Values are “ASC” OR “DESC”.

  • Orderby
    [wpnw_news_ticker orderby="date"]
    Set orderby for news tickers. You can set “date” (News Published Date), “modified” (News updated date), “title” (News Title), “rand” (Random), “menu_order” (Sort Order), “ID” (News Post ID).

  • Link Target
    [wpnw_news_ticker link_target="self"]
    Open Link in same window OR in New tab . Values are “self ” OR “Blank”.

  • Display Posts
    [wpnw_news_ticker posts="40"]
    Display specific News posts.You can pass multiple post ids by comma separated.

  • Exclude Post
    [wpnw_news_ticker exclude_post="40"]
    Exclude some news ticker which you do not want to display.)

  • Exclude Category
    [wpnw_news_ticker exclude_cat="25"]
    Exclude category which you don’t want to display. You can pass multiple category ids by comma separated.

  • Query Offset
    [wpnw_news_ticker query_offset="5"]
    This will hide first five post. E.g I have set offset 5 then it will skip first five post.

    Note: Do not use with pagination and limit parameter.

Widgets

Added 5 News widgets

all-news-widget

Bellow screen shows 5 News widget with their settings.

all-news-widget-view

News widget front-end view.

all-news-widget-designs

News with Custom Order

You can display News in custom order with Drag & Drop interface. Click on ‘Sort News’ link on News listing page, Drag News row and click the ‘Save Sort Order’ button to save.
news-pro

Note: Put orderby='menu_order' order="ASC" parameter in News shortcode for custom ordering.

Frequently Asked Questions

Q: How can I change news post type slug?
A: You need to add below code in your theme’s functions.php file.
Note: After adding below code please update your site permalink structure from admin panel Settings >> Permalinks
Q: How can I change news post type category slug?
A: You need to add below code in your theme’s functions.php file.
Note: After adding below code please update your site permalink structure from admin panel Settings >> Permalinks