FAQs

Installation

What should I do with the ZIP file?

The free widget and the pro are two separate widgets. The pro widget is not an update from the free widget.

Pro widget installation:
Upload the ZIP file with WordPress (Dashboard > Plugins > Installed Plugins > “Add New” button > “Upload Plugin” button >) or copy it to your plugin folder ([your-wp-installation]/wp-content/plugins/term-and-category-based-posts-widget) to your WordPress installation.

How to activate the widget

Installation

Upload the ZIP file with WordPress (Dashboard > Plugins > Installed Plugins > “Add New” button > “Upload Plugin” button >) or copy it to your plugin folder ([your-wp-installation]/wp-content/plugins/term-and-category-based-posts-widget) to your wordpress installation.

How to activate the widget

In the admin panel  Plugins > Installed Plugins > Term and Category Based Posts Widget is an action link License below the widget name. Click this and you come to the Licens activation admin panel.

plugins-action-link
plugins action link

In the License activation panel you have to enter your license key and Save Changes button. Up to now your widget is activated and is visible placeble to your widget areas or as shortcode to the content.

Licens activation
Licens activation

If you want to deactivate the license, for example in order to move it to another site, submit an empty value as the license key.

License transfer between sites

Sometimes when going from development to production the domain of the site changes and if you’re not going to keep a live development server, it doesn’t make any sense for both the user or us to make the user buy two licenses just for that.
With Term and Category based Posts Widget v4.7 and heigher you’ll be able to just deactivate the license on your development site and activate it on production.

 

Use the widget

How to use Shortcode

How to use Shortcode

Write the shortcode slag or use the buttons in the editor toolbar
Write the shortcode slag or use the buttons in the editor toolbar

By using the [termposts] shortcode (for the free version use [catposts]) you can insert a unique widget into any place in a content. The shortcode has the same functionality and configuration options as a “normal” widget.

Inserting removing and configuring a shortcode

The shortcode [termposts] (for the free version use [catposts]) can be inserted in any type of content, anywhere. It is basically used to indicated where the widget will be displayed in the content. There can be only one shortcode per post/content, you can insert two but it will just present the same content in both places. Remove it by deleting the shortcode from the content.

After saving the post (or saving as draft) you can go with one click to the customizer
After saving the post (or saving as draft) you can go with one click to the customizer

Once the shortcode is in the content you need to get to the customizer for the post. The easiest way to do that is to go into preview from the post editing screen and click the “Customize” menu on the “admin bar” (Width one click to the customizer).  In the customizer you will find the “Category Posts Shortcode” section and entering it will show a form which the shortcode can be configured.

In the customizer use the lowest panel to configurate the widget options
In the customizer use the lowest panel to configurate the widget options

For more you can read our blog posts about shortcode or the documentation.

How to use Post List Alterations

How to use “Post item Alterations”

Alterations enable you to “spice up” the display by having different style for post items based on their location, e.g post item alteration or masonry with post item alteration. When alteration mode active two additional panels. One to alterate thumbnail and one to alterate details setting.
In the style panel itself, you can configure the pattern which is used to decide when alteration is being displayed.

There are two possible alteration patterns – first (normal) / last (alteration), and a general pattern.

Thumbnails and Thumbnails alterations

Here you can control how thumbnails are being displayed. The thumbnails is used to control the display of the thumbnails on the “main” items, while the “Thumbnails alterations” panel (displayed only when alterations are active) is used to control the display of the thumbnails in the alterations.

Post details and Post details alterations

Here You can control what text will appear as part of the post description. The “Post details” panel is used to control the display of the post details on the “main” items, while the “Post details alterations” panel (displayed only when alterations are active) is used to control the display of the post details in the alterations.

Template, placeholder and Post Details

Here you can control the post detail parts, which appears as part of the post item. All post detail will placed as placeholder. The text in the Template area can be a placeholder, plain text, HTML or HTML for font-icons.

  For the SVG-icon HTML we recommend the WordPress Dashicons, which are included as default and can be used without any icon-font including.

Placeholders:

New line Space
Empty line Next line is a paragraph
%title% Post title
%thumb% Post thumbnail possibly wrapped by text
%date% Post publish date
%excerpt% Post excerpt
%author% Post author
%commentnum% The number of comments to the post
%post_tag% Post tags
%category% Post categories

  How it works? and Examples.

Slideshow as image slider

The Slideshow can be used as image slider, if the filter is selected to Post Type: Media. Therefor we recommend the Media Library Organizer plugin to create Media Categories for the Media pictures which can be easily selected also with our widget filter.

 

Front-end hacks

Little CSS dips to get huge effects for your front-end, which can be added with the Customizer.

Insert a comma or other separator between Tags and Categories

Comma between Tags

To insert a comma or other separator between Tags or Categories () in the Template use the :after CSS pseudo class and add this selector to your Customizer.

CSS to add a comma between Tags:

.cat-post-tax-post_tag a:not(:last-child):after
{
content:",";
}

CSS to add a comma between Categories:

.cat-post-tax-category a:not(:last-child):after
{
content:",";
}

Slideshow should show different sizes

You create a Slideshow and filter only for Post Types: Media. The Media images can be uploaded in different sizes with different widths. But the option setting for dimension width is only for all images. To get rid of disturbing space for smaller images than others, add this CSS to your Customizer:

.cat-post-item {
max-width: min-content !important;
width: initial !important;
}

Slideshow with different image sizes

 

License

Activation time is unlimited

After one year a renewal license is needed to get further brand new updates. The widget is still active – for unlimited time.

Free trail on localhost

With Term and Category based Posts Widget v4.7 and higher we will let people to download a version which don’t requires a license as long Term and Category based Posts Widget is used on a localhost development server (or the site domain resolves to the local host IP: 127.0.0.1). This hopefully will let users check the relevant features before buying.

 You can find the download link here: Free trail on localhost

License transfer between sites

Sometimes when going from development to production the domain of the site changes and if you’re not going to keep a live development server, it doesn’t make any sense for both the user or us to make the user buy two licenses just for that.
With Term and Category based Posts Widget v4.7 and heigher you’ll be able to just deactivate the license on your development site and activate it on production.
To deactivate the license, submit an empty value as the license key and press save.

 

Page Bilder plugins

How to use Page Bilder plugins like Divi, SiteOrigin Page Builder or Elementor

How our widgets works with SiteOrigin Page Builder

Please add the widget with shorcode inside a editor widget which is placed to a SigeOrigin Page Builder row.

We also create a YouTube video: http://tiptoppress.com/how-category-posts-widget-work-with-siteorigin-page-builder/

How our widgets work with Divi Builder

You can create a new Divi widget area and put our widgets into a Divi Sidebar Module: https://divibooster.com/how-to-put-a-widget-into-divi-module/.

How our widgets works with other page builder plugins like Elementor, Thrive Architect etc.

We recommend for all other page builder plugins like Elementor or Thrive Architect to use the WP Custom Widget Area plugin in additional.

Use the WP Custom Widget Area plugin and create a new custom area with this plugin and place the shortcode (from the new created widget area) to a post or page. Then add our widget to the new created custom widget area at  the widgets admin site (Dashboard > Appearance > Widgets > … ).

 

For more questions write us a message.