IntelliWidget Settings

Parent and Child Profiles

IntelliWidget provides enormous flexibility for customizing the behavior of dynamic sidebars through the use of Parent and Child Profiles and overrides.

Add New IntelliWidget

Parent Profile

The Widgets Admin (under “Appearance > Widgets”) is the starting point for all IntelliWidgets. When you drag a new IntelliWidget into a sidebar region, it becomes the “Parent Profile” for that widget instance. For content to appear, there must be at least one IntelliWidget loaded in one of your dynamic sidebar regions. You can then replace the settings for any Parent Profile with Child Profile on any page or post (see below).

Edit Page IntelliWidget Profiles

Child Profile

IntelliWidget displays a new meta box on each Edit Post admin page titled “IntelliWidget Profiles” to create and edit Child Profiles. A Child Profile is a group of settings on a specific page or post that replaces the Parent Profile for that page or post only.

Add New Child Profile

Add New Child Profile

Click this link to add a new Child Profile tab to the Edit Page or Post form. Once a new Profile tab is added, you can customize it using settings below.

Replace Parent Profile

Parent Profile to Replace

This menu contains every active Parent Profile in your main Widgets Admin. Each page can have its own custom settings for each active Parent Profile. If two Child Profiles are replacing the same Parent Profile, the settings from the higher numbered Profile are used.

If you want to insert IntelliWidget content in the page using the shortcode, select “Shortcode in Post Content.” See IntelliWidget Shortcode for more information.

When the page or post is displayed in the front end and Child Profile settings exist for a Parent Profile, the Child Profile settings are used instead.

This setting defaults to “Unassigned,” so if you are not seeing your custom settings, make sure you have selected a Parent Profile to replace.

use-profile

Use Profiles From

If you have a number of pages or posts that will be using the same Profile settings, you can reuse and existing Child Profiles from another page or post by selecting a Page or Post from the “Use Profiles from” menu.

override-profile

Override Profiles Selected Above

Even if you are using Profiles from another page or post, you can still customize individual Child Profiles on a page or post by checking the “Override profiles selected above” box.

placeholder-select

Placeholder Profile

There may be cases when you do not want to display anything at all unless Child Profile settings exist on the page or post. From the Parent Profile, check “Placeholder Only (do not display)” to display the IntelliWidget only when Child Profile settings exist.

This is useful if you only a sub-set of pages need sidebar content. You can then customize the Child Profiles on the pages or posts themselves. Checking this box will hide the rest of the Parent Profile settings.

Delete

Parent Profiles (Widgets Admin): Click this link to remove the IntelliWidget from the sidebar. If you want to keep the settings for later, drag it to the “Inactive Widgets” section instead.

Child Profiles (Edit Page or Post Admin): Click this link to remove the Profile Tab from the IntelliWidget Profiles meta box.

General Settings Panel

General Settings

These settings apply to all IntelliWidgets, including the type of IntelliWidget, the Section Title, HTML container id and CSS classes.

IntelliWidget Type

This menu controls the type of IntelliWidget to display and the other settings available. “Posts” is selected by default and will be used most of the time. The other option is “Nav Menu” which lets you choose any Menu you may have saved under the “Appearance > Menus” Admin. If you are using IntelliWidget extensions, they will appear as options here as well.

Title

The title text appears at the top of the widget output. If you don’t want a title, leave it blank. If the Parent Profile is replaced by an Child Profile on a specific page, the Child Profile’s Title is used, even if it is blank.

  • Default: Blank
  • Shortcode attribute: title
  • Shortcode value: (string)

Check the box next to the Title input if you want the title to click through to an archive.

  1. If the IntelliWidget uses a term to filter results (see “Terms”), then the title clicks through to that term’s archive page.
  2. If more than one term is used to filter results, then the title clicks through to the term with the highest number of posts associated with it.
  3. Otherwise, the title clicks through to the first post in the list.
  • Default: False (unchecked)
  • Shortcode attribute: link_title
  • Shortcode value: 1
Unique ID

If you want to name this IntelliWidget section with a specific id value, enter it here. Note that ids must be unique to the page.

  • Default: Blank
  • Shortcode attribute: container_id
  • Shortcode value: (string)
Classes

If you want to wrap the entire IntelliWidget output in a specific style class, you can enter it here. This is useful when using IntelliWidgets for slideshows or sliders, responsive menus, or when you want to have the entire section utilize a custom style from your main stylesheet(s). Important: Seperate multiple classes with spaces, not commas.

  • Default: Blank
  • Shortcode attribute: classes
  • Shortcode value: (string)

Post Selection Panel

Post Selection

These settings control the template used and the posts that are displayed. You can select post type, taxonomy terms and date conditions. You can also restrict selection to specific posts.

Template

Templates control the way the IntelliWidget generates output. There are several templates included in the plugin, but you can add and customize as many as you want (see “Templates”).

  • Default: Menu
  • Shortcode attribute: template
  • Shortcode value: (template filename without extension)
Post Types

You can select specific post types to display in the results. If you are using custom post types, they will appear as options here as well (see “Custom Post Types”).

  • Default: Page, Post
  • Shortcode attribute: post_types
  • Shortcode value: (post_types separated by commas)
Terms

If you are using Categories, Tags or other taxonomies for your Posts, you can choose any number of terms from this menu to filter the posts displayed in the output. Posts are displayed if they are members of any of the selected terms. Note that only terms related to the Post Types selected above will be displayed as options in the menu.

  • Default: None
  • Shortcode attribute: category
  • Shortcode value: (category_ID)
Specific Post(s)

You can display specific posts by selecting them from this menu. Control-click to select multiple pages/posts. If no pages are selected, and no category is selected, IntelliWidget displays all results (limited by “Max Posts”).

  • Default: None
  • Shortcode attribute: page
  • Shortcode value: (page_IDs separated by commas)
Exclude current post

Check this box to keep the current post (the page you are on) from showing up in the IntelliWidget.

  • Default: False (unchecked)
  • Shortcode attribute: skip_post
  • Shortcode value: 1
Only future posts

Check this box to only display Posts whose Start Date is later than the current date. You can use this feature to create a calendar of coming events by setting the Start Date to the date of the event in the “IntelliWidget Custom Fields” Meta Box. Note: you will need to modify your functions.php file to correctly display posts using this value. See Using IntelliWidget Date Features.

  • Default: False (unchecked)
  • Shortcode attribute: future_only
  • Shortcode value: 1
Exclude future posts

Check this box to only display Posts whose Start Date is earlier than the current date. See Using IntelliWidget Date Features.

  • Default: False (unchecked)
  • Shortcode attribute: active_only
  • Shortcode value: 1
Exclude expired posts

Check this box to hide Posts whose Expire Date is earlier than the current date. You can use this setting to automatically remove content based on date and time. You can also combine with “Only Future Posts” and “Exclude Future Posts” to only display posts that are occurring now. See Using IntelliWidget Date Features.

  • Default: False (unchecked)
  • Shortcode attribute: skip_expired
  • Shortcode value: 1
Include private posts

Check this box to allow posts marked “Private” to appear in the post list. Only users with the capability to ‘read_private_posts’ will see the private posts as links and be able to read them.

  • Default: False (unchecked)
  • Shortcode attribute: include_private
  • Shortcode value: 1

Appearance Panel

Appearance

You can control the number of posts displayed, excerpt length, featured image and other behaviors with these settings.

Sort by
  • Values:
    • Date – the Post’s Publish Date.
    • Start Date – the Post’s Start Date (Custom Data Field)
    • Order – the Post’s Menu Order
    • Title – alphabetically, by the Post’s Title
    • Random – displays Posts in random order
  • Default: Title
  • Shortcode attribute: sortby
  • Shortcode value: date, title, event_date, menu_order, rand
Order

Choose either ascending (ASC) or descending (DESC) order.

  • Default: ASC
  • Shortcode attribute: sortorder
  • Shortcode value: ASC, DESC
Max posts

Enter the number of posts to display.

  • Default: 5
  • Shortcode attribute: items
  • Shortcode value: "all" or (integer)
Max words per post

Enter the number of words to display in the excerpt (if the template displays post content).

  • Default: 15
  • Shortcode attribute: length
  • Shortcode value: (integer)

You can type any arbitrary text here and it will appear as a link at the end of the excerpt text when using the “Big Date” and “Excerpts” templates.

  • Default: “Read More”
  • Shortcode attribute: link_text
  • Shortcode value: (string)
Allowed Tags

By default, HTML is stripped from the post content. Enter any HTML tags that you do not not wish to remove. Do not include > or < characters.

  • Default: Blank
  • Shortcode attribute: allowed_tags
  • Shortcode value: (string)
Image Align

The “big date,” “excerpts” and “menu” templates will display thumbnail images for each post displayed (using the “featured image” if it exists). You can select “Left,” “Right,” “Center” or “None.”

  • Default: None
  • Shortcode attribute: imagealign
  • Shortcode value: none, left, center, right
Image Size

The “excerpts” and “menu” templates will display thumbnail images for each post displayed (using the “featured image” if it exists). You can select “thumbnail,” “medium,” “large,” “full,” or “no image.” The default is “no image.” The default stylesheet automatically constrains the “thumbnail” size to 25% of the column width. Any of the other sizes will probably be too large for most applications, but we include the option for flexibility.

  • Default: Thumbnail
  • Shortcode attribute: image_size
  • Shortcode value: thumbnail, medium, large, full

Additional Text Panel

Additional Text

These settings allow you to add additional text to display above or below the IntelliWidget output. If your theme supports shortcodes in text widgets, you can use them here. If your user account has HTML editing capabilities, you can enter HTML as well.

Display

Select “Above Posts” or “Below Posts” to display text above/below the menu/list. Select “This text only (no posts)” to make this a text widget (useful if your override is contact info or directions, etc.) Select “None” to disable the Additional Text feature for this IntelliWidget Profile.

  • Default: None
  • Shortcode attribute: NOT SUPPORTED
Text Area

Type or past text or HTML in the box. IntelliWidget uses the same logic as the WordPress core Text Widget for filtering raw HTML from the inputs for users without the freedom to post HTML.

  • Default: Blank
  • Shortcode attribute: NOT SUPPORTED
Automatically add paragraphs

Just like a Text Widget, you can automatically auto-format paragraphs in your custom text by checking this box.

  • Default: False (unchecked)
  • Shortcode attribute: NOT SUPPORTED

nav-menu-select

Use this setting to select a Custom Menu from the available custom menus available in Appearance > Menus or to generate a menu automatically from the existing pages in your site.
Select “Automatic Page Menu” to use the automatic menu feature.

  • Default: None
  • Shortcode attribute: nav_menu
  • Shortcode value: (nav_menu_ID)

Need More Help? Contact Us!

Maintaining our reputation for excellent support is very important to us, so please do not hesitate to ask any question about this or any of our other plugins. You can also use the Child Theme Configurator Support Forum on WordPress.org. Don't forget to give us 5 stars!