The Widget Pack includes a set of feature rich, versatile and highly configurable widgets that can be used to enhance your directory. The widgets included are:

Search
Keyword search of the directory.
Category
A list of links of your categories.
List
A limited list of entries from your directory.
Anniversaries Today
A list of anniversaries occurring today.
Birthdays Today
A list of birthdays occurring today.
Upcoming Anniversaries
A list of upcoming anniversaries.
Upcoming Birthdays
A list of upcoming birthdays.
Upcoming Event Dates
A list of upcoming date events that have been added to the entries.
Recently Added
A list of entries that were recently added to the directory.
Recently Updated
A list of entries that were recently updated.

Features:

All widgets designed to be high performance to have very little impact on page load times. This is accomplished by utilizing fragment caching. Without going into great technical detail, this means the HTML for the widgets are built once and then served from a cache anytime they are needed. This reduces server load, response time, database queries and the memory required. The cache version is never out of date as it is recreated once a day or any time you update an entry or change a widget setting.

All widgets support multiple instances. This means you can add the same widget to your sidebar multiple times each being configured separately.

All widgets support being used as a shortcode on a page.

Category widget features:

Display all categories or include specific categories or exclude categories.
Choose to limit the list to a defined category and decide whether only the immediate children categories are shown or all descendants are shown.
If displaying all categories, you can choose to define how many levels deep the category tree should display.
Decide whether or not the number of entries assign to the category should be shown.
You can choose to hide empty categories.

The list, anniversary, birthday, recently added and modified features include:

The option the include or exclude entries assigned to categories.
Choose to display the entry photo or logo.
Control how the name is formatted.
An option to display the name as a link to the entries profile page.
Decide to hide the widget if there are no entries to show, a very handy feature for the anniversaries and birthdays today widgets.
Limit the number of entries shown in the list.

Changelog

Show Change Log

= 2.13 08/25/2023 =

TWEAK: Add class property to template class objects to prevent “Creation of dynamic property” PHP notices.
TWEAK: Add the Pad Counts option to the Categories Widget.

= 2.12 04/07/2023 =

NEW: Introduce the Connections_Directory/Widget_Pack/Widget/Category/Use_Fragment_Cache filter.
TWEAK: Change the placement of the add/remove filter for cn_term_list_class when rendering the Categories widget.
TWEAK: Make the callback for the cn_term_list_class filter a closure.
BUG: Ensure term counts are padded when displaying the category counts.
OTHER: Change the capitalization of the filename.
DEV: Remove the use of the cnCache::clear() deprecated method and cnFragment() deprecated class name.
DEV: Remove the use of the deprecated cnFragment class.

= 2.11 02/17/2023 =

NEW: Introduce the Connections_Directory/Widget_Pack/Widget/Search/Form_Action filter.
OTHER: Update the copyright year.
DEV: Bump requires PHP to >= 7.0 and WP >= 5.6.
DEV: Update the plugin’s readme.txt plugin header.

= 2.10 07/29/2022 =

NEW: Introduce Connections_Widgets::getPath() and Connections_Widgets::getURL().
TWEAK: Introduce helper class Widget_Pack\Script and move CSS/JS registering and enqueuing code into it.
TWEAK: Prevent directory access to widgets.
DEV: phpDoc updates.

= 2.9.1 02/07/2022 =

TWEAK: Add additional hooks to clear the widget fragment cache to better support the preview in the Customizer.
BUG: Add a default value for the str_img_placeholder array to prevent a PHP warning.

= 2.9 01/06/2022 =

NEW: Introduce Widget_Pack\Register_Widget trait.
TWEAK: Utilize the Widget_Pack\Register_Widget trait to reduce code duplication.
TWEAK: Correct class assigned to the list widget.
TWEAK: Update the Entry List Widget to utilize the Fragment_Cache trait for more reliable fragment cache validation and clearing when using the new Widgets admin screen.
TWEAK: Utilize the Widget_Pack\Fragment_Cache trait in the categories widget for consistency with the other widgets.
TWEAK: Update widgets so checkboxes are properly saved in WordPress >= 5.8.
OTHER: Correct misspellings.
DEV: phpDoc correction.
DEV: phpDoc updates.
DEV: Remove the use of a deprecated method.
DEV: Remove unused variables.
DEV: Remove use of deprecated parameter attribute.
DEV: Remove unused class constant.
DEV: Remove unused global constants.
DEV: Code reflow.

= 2.8 09/17/2021 =

TWEAK: Improve compatibility with WordPress >= 5.8 and the new Widgets admin page. Ensure the widget preview is properly refreshed after widget settings changes.
TWEAK: Ensure variable is instance of cnTemplate before accessing it.
TWEAK: Add suppress_filters parameter to calls to cnRetrieve::entries().
TWEAK: Set parse_request to false when calling cnRetrieve::entries().
TWEAK: Add private widget id property to widget classes for consistency and code deduplication.
TWEAK: Check for instance of cnEntry_Date before accessing object.
BUG: Ensure the “Link to Entry?” option in the widgets are correctly applied.
OTHER: Remove commit meta from changelog.
DEV: phpDoc corrections.
DEV: Code formatting.
DEV: Add newline for code formatting consistency.
DEV: Correct inline doc.

= 2.7.1 07/26/2021 =

TWEAK: Remove use of `create_function()`.
TWEAK: Add CSS selector for new Widget Block Editor.
TWEAK: Maybe JSON decode the category and exclude_category parameters when saving the updated widget setting. This fixes an error of not being able to save widget changes in the new Widget Block Editor.

= 2.7 03/15/2021 =

TWEAK: Check for the `$show_title` variable in the search widget and default to `true` if not set.
TWEAK: Add the missing `widget_title` filter to the search widget.
TWEAK: Check for empty `$title` and before rendering.
TWEAK: Update search widget settings form markup to mimic current WP markup.
TWEAK: Update search widget update callback to include sanitization for the widget title.
TWEAK: Set title defaults in the widget settings admin render callback that allows it to be overridden with any value entered by the user, even if it is empty.
BUG: Add and remove the `cn_term_list_class` filter in the category widget closer to the term tree walker.
I18N: Update Dutch (Netherlands) translations.
OTHER: Update copyright year.
OTHER: Update plugin naming to match current conventions.
OTHER: Update links in plugin docs from `http` to `https`.
OTHER: Correct misspelling in widget class name.
DEV: Correct code alignment.
DEV: Update required/tested versions in the readme.txt file.
DEV: Add inline phpDoc for function variables in the search widget.
DEV: phpDoc updates.

= 2.6.1 10/04/2018 =

TWEAK: Beaver Builder compatibility tweak.
TWEAK: Elementor compatibility tweak.

= 2.6 09/25/2018 =

FEATURE: Add a new upcoming widget that can be configured to display a list of any of the available event dates.
TWEAK: Only show image option in List widget when one of the image options is chosen.
BUG: Need to set the `page_id` if the directory home page is the same as the home page so searches are correctly processed by WordPress.
BUG: Correct undefined index PHP notice.
BUG: Correct undefined variable PHP notice.
DEV: Readme.txt updates.

= 2.5 04/24/2018 =

TWEAK: Prevent index undefined notice by checking for `wp_inactive_widgets` and displaying a user message stating the widget was found but is inactive.
TWEAK: HTML tweak to the category list widget.
TWEAK: Minor CSS tweaks to the category list widget.
BUG: Add missing text domain to string.
BUG: Correct widget option description.
I18N: Update POT file.
I18N: Add Portuguese – PORTUGAL (PT) (pt_PT) translation.
I18N: Update all included translations.
OTHER: Plugin header name and description updates.
OTHER: Update copyright year.
DEV: Add phpDoc.

= 2.4 08/26/2016 =

FEATURE: Add an “Expand” and “Accordion” layout style option to the Category List widget.
BUG: Add missing closing `span` tag.
I18N: Update .POT file.
I18N: Include Spanish (Mexico) translation.
I18N: Update nl_NL Translation.

= 2.3 04/28/2016 =

NEW: Add filter to list widget to allow other image types to be added; such as SiteShot.
TWEAK: Refactor the recently added widget template to support other image image options register with the `cn_widget_list_image_options` filter.
TWEAK: Make the date the default image in the birthday and anniversaries widgets.
OTHER: Correct misspelling.
DEV: Add some phpDoc.

= 2.2 06/17/2015 =

FEATURE: Add a randomization option to the List Widget.

= 2.1 06/09/2015 =

FEATURE: New List Widget.

= 2.0.1 05/25/2015 =

TWEAK: Minor phpDoc fixes.
TWEAK: Remove priority and argument count from a couple of actions as they were unnecessary.
TWEAK: Add a helper function to render widgets.
BUG: Correct display label in the today’s birthdays widget.
BUG: Fix bug that prevented the widget from outputting correctly when the do not display widget when no results option was disabled.

= 2.0 04/16/2015 =

FEATURE: Complete rewrite.
FEATURE: All widgets can be used as shortcodes.
FEATURE: Category Widget – Option to define which categories to include or exclude.
FEATURE: Category Widget – Option to display a specific category children categories.
FEATURE: Category Widget – Option to limit the category level depth to display.
FEATURE: Category Widget – Option to show the number of entries assigned to the category.
FEATURE: Category Widget – Option to show or hide empty categories.
FEATURE: Anniversary/Birthday – Limit entries to specific categories and whether the entry must be within all selected categories or not.
FEATURE: Anniversary/Birthday – Exclude entries assigned to specific categories.
FEATURE: Anniversary/Birthday – Whether or not to display the entry image or logo or none.
FEATURE: Anniversary/Birthday – Option to control the format of the name.
FEATURE: Anniversary/Birthday – Option to link to the entry profile page or not.
FEATURE: Anniversary/Birthday – Option to display the widget or not if there are no birthdays/anniversaries today.
FEATURE: Anniversary/Birthday – Option to define the “No results” message.
FEATURE: Anniversary/Birthday – Option to limit the max number of entries to display.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Limit entries to specific categories and whether the entry must be within all selected categories or not.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Exclude entries assigned to specific categories.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Whether or not to display the entry date or image or logo or none.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Option to control the format of the name.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Option to link to the entry profile page or not.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Option to display the widget or not if there are no birthdays/anniversaries today.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Option to define the “No results” message.
FEATURE: Upcoming Anniversary/Upcoming Birthday – Option to limit the max number of days to look ahead for upcoming birthdays/anniversaries.
FEATURE: Recently Added/ Recently Modified – Limit entries to specific categories and whether the entry must be within all selected categories or not.
FEATURE: Recently Added/ Recently Modified – Exclude entries assigned to specific categories.
FEATURE: Recently Added/ Recently Modified – Whether or not to display the entry date or image or logo or none.
FEATURE: Recently Added/ Recently Modified – Option to control the format of the name.
FEATURE: Recently Added/ Recently Modified – Option to link to the entry profile page or not.
FEATURE: Recently Added/ Recently Modified – Option to limit the max number of entries to display.
TWEAK: Convert code to singleton pattern.
TWEAK: Break out each widget into its own file.
TWEAK: Prevent direct access of widgets.
TWEAK: Add blank index.php files.
TWEAK: Remove use of PHP short tag.
TWEAK: Widgets now use the core template engine.
OTHER: Update plugin header.
OTHER: Add license.txt.
OTHER: Add gpl.txt.
OTHER: Change changelog.txt file name case.
DEV: Add .editorconfig file.
DEV: Add phpStorm to .gitignore.
DEV: Add .jshintrc

= 1.2 09/18/2013 =

TWEAK: Force links in the widgets to resolve to the directory home page.

= 1.1.2 08/25/2013 =

* BUG: Fix grammar.

= 1.1.1 07/25/2013 =

BUG: Remove stray debug code.

= 1.1 07/24/2013 =

Add Dutch translation.

= 1.0.1 07/17/2013 =

Remove the page_link filter from the search widget so it’ll search the entire directory when on a directory page.
Move the changelog.txt file.

= 1.0 10/1/2012 =

Initial Release