Search the Widget Pack FAQs
Installation
Before starting the installation, you must ensure the Connections Business Directory plugin is installed and set up. If you have not done this already, please take a moment to read and follow the quick start installation guide.
- You install the Widget Pack extension like you would any other WordPress Plugin. Follow these steps.

- First, navigate to the Plugins menu and click Add New.

- Next, click the Upload Plugin button at the top of the page.
- Now browse to where you downloaded the Widget Pack zip file and select it.

- Click the Install Now button.
- Upon successful installation, click the Activate Plugin link.
- Set the Directory Home Page. This will be the page with which all widgets interact.
Support License Activation

To receive updates for the template, you must activate your support license key.

- Navigate to the Connections : Settings admin page and click the Licenses tab.
- Enter the support license key that you received in your email receipt, and then click the Activate button. With your support license key activated, and when there is an update, you will be notified by the WordPress admin. Now you can update to the latest version when notified with a single click.
Widget Descriptions
The Widget Pack includes the following widgets:
- Search :: This widget displays a keyword search field. Your users can use it to search your directory.
- Category :: This widget displays a list of category links.
- List :: This widget displays a limited list of entries from your directory. The list can include or exclude entries from specific categories.
- Anniversaries Today :: This widget displays a list of today’s anniversaries.
- Birthdays Today :: This widget displays a list of today’s birthdays.
- Upcoming Anniversaries :: This widget displays a list of upcoming anniversaries.
- Upcoming Birthdays :: This widget displays a list of upcoming birthdays.
- Recently Added :: This widget displays a list of recently added entries.
- Recently Updated :: This widget displays a list of recently updated entries.
Displaying Widgets
Before you can add a widget, you must verify that the theme you are using supports widgets. You can do so by navigating to the Appearance menu and looking for a sub-menu titled Widgets. If the sub-menu exists, then your theme supports displaying widgets.
To display the widgets in your theme’s sidebar, follow these steps:
- Navigate to Appearance > Widgets page in the WordPress admin.
- Choose a widget and drag it to the sidebar where you wish it to appear, or click the widget, select a destination sidebar if your theme has more than one, and then click the Add Widget button. Once you add the widget, WordPress will automatically save it with its default settings.
Widget Configuration
To configure a widget, you must first add your chosen widget to the theme’s sidebar. Many of the widgets share the same set of options. For completeness, all widget options are listed under each widget, even though it is duplicate information.
Search

The search widget has a single option, the widget Title. The default title is “Search Directory”. You can change the title to any text that best describes it on your website.
Categories

The Categories widget includes the following options:
- Configurable widget title.
- Display all categories or include specific categories, or exclude specific categories.
- Choose to limit the list to a defined category and decide whether to show only the immediate children categories or all descendant categories.
- When displaying all categories, you can limit how many levels deep the category tree should display.
- Decide whether to show the number of entries assigned to the category.
- You can choose whether to hide empty categories.
Entry List

The Entry List widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Anniversaries Today

The Anniversaries Today widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Birthdays Today

The Birthdays Today widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Upcoming Anniversaries

The Upcoming Anniversaries widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Upcoming Birthdays

The Upcoming Birthdays widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Recently Added

The Recently Added widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Recently Modified

The Recently Modified widget includes the following options:
- Include or exclude entries based on their assigned categories.
- Choose to display the entry photo or logo.
- Control the formatting of the name.
- You can optionally display the name as a link to the entries profile page.
- Limit the number of entries shown in the list.
Remove a Widget
- Navigate to Appearance > Widgets page in the WordPress admin.
- Decide which sidebar you want to remove your widget if multiple options exist.
- To remove a widget, click the widget’s name to remove or the down arrow in the upper right corner to expand the widget’s options.
- Click the Delete link at the bottom of its options to remove the widget permanently.
Moving a Widget
- Navigate to Appearance > Widgets page in the WordPress admin.
- Click on the widget title and hold the mouse button down. Then drag the widget up or down to the desired location. Now release the mouse button to drop the widget into the new location.
Advanced
Widget Shortcodes

Important
You can display each included widget on the page with a shortcode. You will find a new sidebar name Connections: Widget Shortcode on the Widgets page in the WordPress admin.
Add the desired widget to this sidebar and configure it usually. After you click the Save button, you will receive a shortcode that you can place on the page.
FAQs
How do I disable the widget fragment cache?
- Install the Code Snippets plugin.
- Add a new code snippet with the following code.
- Save and activate the new code snippet.
add_filter( 'Connections_Directory/Widget_Pack/Widget/Category/Use_Fragment_Cache', '__return_false' );
Important
How do I highlight the active category?
Add the following CSS to the theme’s custom CSS area found in the Customizer:
.widget_cnw_categories li.cat-item.current-cat { background-color: #666; padding: 6px 12px; } .widget_cnw_categories li.current-cat a { color: #fff; }
Tweak the colors as desired.
Important
How do I update from Widget Pack 1.x to 2.x?
Updating from Widget Pack 1.x to 2.x should be fairly quick and easy.
- First, deactivate Widget Pack 1.x.
- Next, delete it.
- Now follow the Extension Installation Instructions.
- Go to the Connections : Settings admin page and enter your support license key under the Licenses tab.
- Lastly go to the Widgets admin page, add and configure your new Connections Widgets.
Please be sure you follow Step 4. After you add your support license key, you will receive update notification in your WordPress admin everytime an update for the Widget Pack is released. This will also also enable inplace, single click, updates.
NOTE: This is a major update, you may have to re-add and configure the Connections Widgets that were placed in the theme’s sidebars.