=== Connections Business Directory ===
Contributors: shazahm1@hotmail.com
Donate link: https://connections-pro.com/
Tags: address book, business directory, chamber of commerce business directory, church directory, company business directory, contact directory, custom business directory, directory, directory plugin, listings directory, local business directory, link directory, member directory, staff directory
Requires at least: 4.5.3
Tested up to: 4.9
Requires PHP: 5.3
Stable tag: 8.25.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

An easy to use directory plugin to create an addressbook, business directory, member directory, staff directory or church directory.

== Description ==

[Showcase](https://connections-pro.com/showcase/) | [Documentation](https://connections-pro.com/documentation/contents/) | [Support](https://connections-pro.com/support/) | [Templates](https://connections-pro.com/templates/) | [Extensions](https://connections-pro.com/extensions/)

Quite simply, Connections Business Directory is one of the [best business directory plugins available](https://wordpress.org/support/plugin/connections/reviews/?filter=5) for WordPress. Its simplicity in design and function, vast array of unique features and versatility are the reasons more and more people are turning to Connections Business Directory for their directory needs. You can use Connections to create a simple address book, maintain a staff or member directory and run a business directory or link directory. Connections Business Directory was built bottom up to be as configurable as possible while providing the features you need. Read on to learn about some of the best features Connections Business Directory has to offer...

= Features =

* **Seamless integration** with WordPress.
* **[Highly rated support.](https://wordpress.org/support/plugin/connections/reviews/?filter=5)**
* [Continuously updated](https://wordpress.org/plugins/connections/#developers) bringing you new features for free.
* Dashboard admin page where you can see at a glance today's anniversaries and birthdays as well as upcoming anniversaries and birthdays of members in your directory.
* Multiple entry types from which to choose; such as individual, organization and family. The family entry type is unique to Connections. This entry type allows you to group individuals together as a family which makes Connections ideally suited for creating a church directory.
* You control which entries are viewable to the public and which entries are private, viewable for logged in users only. You can even have entries set as unlisted so only admins can view them.
* **[Repeatable fields](https://connections-pro.com/documentation/add-entry/#Repeatable_Fields)** for address, phone numbers, email, IM, social media, links and dates which allow you to add as much or as little as you need for each business in your business directory.
* Hierarchical (nested) **category support**. Businesses and members in your business directory can be added to any number of categories.
* Include a biographical text for an individual member or business description for each entry in your business directory using an easy to use rich text editor.
* You can easily add a business logo or photo of the staff member for each entry in your business directory or staff directory. The photo and logo images are fully responsive with **HiDPI (Retina) display support**.
* **Scalable,** manage directories which [contain hundreds of thousands of entries](https://wordpress.org/support/topic/scales-to-at-least-250000-entries).
* **[CSV Export](https://connections-pro.com/documentation/tools/#Export)** of addresses, phone numbers, email addresses and dates.
* **[CSV Import](https://connections-pro.com/documentation/tools/#Categories-2)** of **nested** categories.
* **[Role capability support](https://connections-pro.com/documentation/roles/)**.
* [Displaying your business directory on the frontend is as simple as putting a shortcode on a page.](https://connections-pro.com/documentation/install/#Step_4_Displaying_your_Directory) Don't let this simplicity fool you. The shortcode provides a large array of options that are just too numerous to list. To learn more, [go here](https://connections-pro.com/documentation/plugin/shortcodes/).
* **SEO.** Every entry in your business directory outputs following the [hCard](http://microformats.org/wiki/hcard) spec. Soon to be updated to following Schema.org.
* **[Extensible](https://connections-pro.com/extensions/)** and developer friendly.
* Robust **templating support** with the [Template Customizer](https://connections-pro.com/2015/07/27/feature-preview-template-customizer/). Several basic templates are provided to get you started with you business directory with many more [premium templates available](https://connections-pro.com/templates/) to really make your business directory shine.

= Extensible =

Here are some great **free extensions** (with more on the way) that enhance your experience with Connections Business Directory:

**Utility**

* [Toolbar](https://wordpress.org/plugins/connections-toolbar/) :: Provides quick links to the admin pages from the admin bar.
* [Login](https://wordpress.org/plugins/connections-business-directory-login/) :: Provides a simple to use login shortcode and widget.
* [Anniversary and Birthday Emails](https://wordpress.org/plugins/connections-business-directory-anniversary-and-birthday-emails) :: Add the ability to automatically send a customizable email to entries on their anniversary or birthday.

**Custom Fields**

* [Business Open Hours](https://wordpress.org/plugins/connections-business-directory-hours/) :: Add the business open hours.
* [Certifications](https://wordpress.org/plugins/connections-business-directory-certifications/) :: Create and assign certifications to individuals in your directory.
* [Local Time](https://wordpress.org/plugins/connections-business-directory-local-time/) :: Add the business local time.
* [Facilities](https://wordpress.org/plugins/connections-business-directory-facilities/) :: Add the business facilities.
* [Income Level](https://wordpress.org/plugins/connections-business-directory-income-levels/) :: Add an income level.
* [Education Level](https://wordpress.org/plugins/connections-business-directory-education-levels/) :: Add an education level.
* [Languages](https://wordpress.org/plugins/connections-business-directory-languages/) :: Add languages spoken.
* [Hobbies](https://wordpress.org/plugins/connections-business-directory-hobbies/) :: Add hobbies.

**Misc**

* [Face Detect](https://wordpress.org/plugins/connections-business-directory-face-detect/) :: Applies face detection before cropping an image.

**[Premium Extensions](https://connections-pro.com/extensions/)**

* [Authored](https://connections-pro.com/add-on/authored/) :: Displays a list of blog posts written by the entry on their profile page.
* [Contact](https://connections-pro.com/add-on/contact/) :: Displays a contact form on the entry's profile page to allow your visitors to contact the entry without revealing their email address.
* [CSV Import](https://connections-pro.com/add-on/csv-import/) :: Bulk import your data in to your directory.
* [Custom Category Order](https://connections-pro.com/add-on/custom-category-order/) :: Order your categories exactly as you need them.
* [Custom Entry Order](https://connections-pro.com/add-on/custom-entry-order/) :: Allows you to easily define the order that your business directory entries should be displayed.
* [Enhanced Categories](https://connections-pro.com/add-on/enhanced-categories/) :: Adds many features to the categories.
* [Form](https://connections-pro.com/add-on/form/) :: Allow site visitor to submit entries to your directory. Also provides frontend editing support.
* [Link](https://connections-pro.com/add-on/link/) :: Links a WordPress user to an entry so that user can maintain their entry with or without moderation.
* [ROT13 Encryption](https://connections-pro.com/add-on/rot13-email-encryption/) :: Protect email addresses from being harvested from your business directory by spam bots.
* [SiteShot](https://connections-pro.com/add-on/siteshot/) :: Show a screen capture of the entry's website.
* [Widget Pack](https://connections-pro.com/add-on/widget-pack/) :: A set of feature rich, versatile and highly configurable widgets that can be used to enhance your directory.

**[Premium Templates](https://connections-pro.com/templates/)**

Connections Business Directory comes with a couple templates to get you started which fully support the [Template Customizer](https://connections-pro.com/2015/07/27/feature-preview-template-customizer/). In addition to these free templates there are many premium templates available to take your business directory the level visually.

* [Circled](https://connections-pro.com/add-on/circled/) :: A simple but bold template specifically designed for displaying small team or staff directory.
* [cMap](https://connections-pro.com/add-on/cmap/) :: Our most popular go to template for a business directory and chamber of commerce business directory, featuring full Template Customizer support.
* [Excerpt Plus](https://connections-pro.com/add-on/excerpt-plus/) :: Simple design which features a directory entry name, photo thumbnail and excerpt.
* [Gridder](https://connections-pro.com/add-on/gridder/) :: Another simple but bold template which displays the directory in a grid layout. Perfect for displaying a small team or staff directory
* [Slim Plus](https://connections-pro.com/add-on/slim-plus/) :: Specifically designed to take up as little space on the page as possible.
* [Tile Plus](https://connections-pro.com/add-on/tile-plus/) :: This template was purposely designed to display the directory in a grid or column layout.

= Developer Friendly =

* Open development on [Github](https://github.com/Connections-Business-Directory/Connections).
* Access to **180 action hooks** and over **300 filters** ... and counting.
* Term API.
* Custom Metabox and Fields API.
* Template Engine and API.
* Fragment Cache API.
* Log API (stateless and stateful).
* Admin Notices API.
* Email API.
* Settings API.

Connections Business Directory has a very flexible template engine. The loading of template and CSS are context aware. This means you could create specific templates that load when a user visits a specific entry, category, postal code and more.

Templates and CSS overriding is very granular and update safe. Check out these links for the details:

* [Custom Core CSS](https://connections-pro.com/2014/05/04/quicktip-custom-css/)
* [Custom CSS for Templates](https://connections-pro.com/2014/05/07/quicktip-custom-css-templates/)
* [Custom Template Override File](https://connections-pro.com/2014/06/04/quicktip-custom-template-override-files/)

= Languages =

Connections Business Directory has been embraced around the world and has been translated by its users in the following languages.

* Arabic [60% Complete]
* Catalan [52% Complete]
* Croatian (Croatia) [22% Complete]
* Danish [31% Complete]
* Danish (Denmark) [29% Complete]
* Dutch (Netherlands) [49% Complete]
* Finnish [78% Complete]
* French (France) [90% Complete]
* German (Germany) [86% Complete]
* Greek (Greece) [69% Complete]
* Hebrew (Israel) [61% Complete]
* Hungarian (Hungry) [52% Complete]
* Italian (Italy) [58% Complete]
* Norwegian [13% Complete]
* Persian (Iran) [52% Complete]
* Polish (Poland) [52% Complete]
* Portuguese (Brazil) [77% Complete]
* Portuguese (Portugal) [24% Complete]
* Romanian (Romania) [69% Complete]
* Russian (Russia) [40% Complete]
* Serbian (Latin) [2% Complete]
* Spanish (Latin America) [49% Complete]
* Spanish (Mexico) [99% Complete]
* Spanish (Spain) [99% Complete]
* Sweden (Swedish) [96% Complete]
* Turkish (Turkey) [58% Complete]

== Credits: ==
* Connection Business Directory was based off LBB, ["Little Black Book"](https://wordpress.org/extend/plugins/lbb-little-black-book/); which was based on [Addressbook](https://wordpress.org/extend/plugins/addressbook/), both of which can be found in the Plugin Directory.
* vCard class is a modified version by [Troy Wolf](http://www.troywolf.com/articles/php/class_vcard/).
* Update Notice in plugin admin inspired by Changelogger 1.2.8 by [Oliver Schlöbe](https://wordpress.org/extend/plugins/changelogger/).
* Screen Options class by [Janis Elsts](http://w-shadow.com/blog/2010/06/29/adding-stuff-to-wordpress-screen-options/).
* $.goMap() jQuery Google Maps Plugin by [Jevgenijs Shtrauss](http://www.pittss.lv/jquery/gomap/).
* MarkerClustererPlus jQuery Google Maps Marker Clustering Plugin by [Gary Little](http://gmaps-utility-library-dev.googlecode.com/svn/tags/markerclusterer/).
* Validation jQuery plugin by [Jörn Zaefferer](http://bassistance.de/jquery-plugins/jquery-plugin-validation/).
* Chosen jQuery plugin by [Harvest](https://github.com/harvesthq/chosen/).
* qTip jQuery plugin by [Craig Thompson](http://craigsworks.com/projects/qtip2/).
* Email and URL validation methods by [Gizmo Digital Fusion](http://wpcodesnippets.info/blog/two-useful-php-validation-functions.html).
* Social media icons by [WPZOOM.com](http://www.wpzoom.com/wpzoom/500-free-icons-wpzoom-social-networking-icon-set/); license [CC BY-SA 3.0](http://creativecommons.org/licenses/by-sa/3.0/).
* iTunes icon by [Paul Robert Lloyd](http://paulrobertlloyd.com/); license [Attribution-ShareAlike 2.0 UK: England & Wales (CC BY-SA 2.0)](http://creativecommons.org/licenses/by-sa/2.0/uk/).
* Podcast icon by [schollidesign](http://findicons.com/icon/94188/podcast_new); license GNU/GPL.
* CSS theme and image used for the jQuery UI Datepicker by [helenhousandi](https://github.com/helenhousandi/wp-admin-jquery-ui).

== Screenshots ==

1. The many possible faces of your business directory. Connections Business Directory supports templates. This screenshot showcases (left to right) [Excerpt Plus](https://connections-pro.com/add-on/excerpt-plus/), [Circled](https://connections-pro.com/add-on/circled/), [Gridder](https://connections-pro.com/add-on/gridder/), [Tile Plus](https://connections-pro.com/add-on/tile-plus/) and [Slim Plus](https://connections-pro.com/add-on/slim-plus/).
2. Another screenshot showcasing the different templates that can be used to style your business directory. Left to right; [Circled](https://connections-pro.com/add-on/circled/), [cMap](https://connections-pro.com/add-on/cmap/) and [Gridder](https://connections-pro.com/add-on/gridder/).
3. The [Dashboard admin page](https://connections-pro.com/documentation/dashboard/). A snapshot of important information about the business directory.
4. The [Manage admin page](https://connections-pro.com/documentation/manage/). Here you can manage all the entries within the address book.
5. The [Add New Entry admin page](https://connections-pro.com/documentation/add-entry/). From here you can add new entries to the addressbook.
6. The [Categories admin page](https://connections-pro.com/documentation/categories/). Add as many categories as you wish to the directory. Categories do support parent/child relationships.
7. The [Templates admin page](https://connections-pro.com/documentation/templates/). Here you choose which template that the business directory should use when displaying the directory.
8. The [Settings admin page](https://connections-pro.com/documentation/settings/) where you can configure the business directory options.
9. The [Role and Capabilities admin page](https://connections-pro.com/documentation/roles/). Here you can assign which roles have which capabilities in viewing and managing the directory.
10. The [Tools :: Export admin page](https://connections-pro.com/documentation/tools/#Export) contains many different CSV export tools to allow you to easily export the data from your business directory.
11. The [Tools :: Import admin page](https://connections-pro.com/documentation/tools/#Categories-2) allows you to quickly bulk import nested categories into your business directory.
12. In the event that you need support the [Tools :: System Information admin page](https://connections-pro.com/documentation/tools/#System_Information) contains all the information needs about your directory installation which can be easily and quickly shared.
13. Need to move the configuration of your business directory from one site to another? The [Tools : Settings Import/Export admin page](https://connections-pro.com/documentation/tools/#Settings_ImportExport) allows you to do it with zero fuss. This will even migrate the Template Customizer settings applied to template and any of the settings for the [premium extensions](https://connections-pro.com/extensions/).

[Connections running on live websites can be found here.](https://connections-pro.com/showcase/)

== Frequently Asked Questions ==

A comprehensive list of [FAQs can be found here.](https://connections-pro.com/faq/)

= How do I install Connections? ==
[Installation instructions can be found here.](https://connections-pro.com/documentation/plugin/install/)

Using the WordPress Plugin Search

1. Navigate to the `Add New` sub-page under the Plugins admin page.
2. Search for `connections business directory`.
3. The plugin should be listed first in the search results.
4. Click the `Install Now` link.
5. Lastly click the `Activate Plugin` link to activate the plugin.

Uploading in WordPress Admin

1. [Download the plugin zip file](https://wordpress.org/plugins/connections/) and save it to your computer.
2. Navigate to the `Add New` sub-page under the Plugins admin page.
3. Click the `Upload` link.
4. Select Connections Business Directory zip file from where you saved the zip file on your computer.
5. Click the `Install Now` button.
6. Lastly click the `Activate Plugin` link to activate the plugin.

Using FTP

1. [Download the plugin zip file](https://wordpress.org/plugins/connections/) and save it to your computer.
2. Extract the Connections Business Directory zip file.
3. Create a new directory named `connections` directory in the `../wp-content/plugins/` directory.
4. Upload the files from the folder extracted in Step 2.
4. Activate the plugin on the Plugins admin page.

= How do I display the business directory on my site? =
We have a [QuickStart](https://connections-pro.com/quickstart/) available that'll walk you thru the most basic setup. Basically all you need to do is, create a page, and add the `[connections]` shortcode and then start adding entries to your directory.

= Will it work with my theme? =
Connections Business Directory has been designed to work with any theme.

= Is Connections Business Directory translation-ready? =
Yes it is. Connections Business Directory comes with many user supplied translations. We use Transifex to manage translations. This service make it easy for us manage and easy for you to translate. To read more, see [this page](https://connections-pro.com/documentation/translation/).

= Is Connections Business Directory compatible with WordPress Multisite? =
Yes it is. However, do not Network activate Connections. Activate it on only the subsites that you wish to use Connections.

= Is it possible to share entries with other sites within a WordPress Multisite installation? =
Yes this is possible but there is a special setup required to do so. It is recommended this is done before added entries to your business directory.

1. Activate Connections Business Directory the primary site.
2. Add `define( 'CN_MULTISITE_ENABLED', FALSE );` to your `wp-config.php` file. **NOTE:** If you have added any entries to any of your subsites, that data will be lost as Connections will read the directory entry data from the primary site's database tables.
3. Activate Connections Business Directory on the subsites you wish to use Connections.

= What are the requirements to run Connections? =
* **WordPress version:** >= 4.4
* **PHP version:** >= 5.2.4 ( >= 7.0 is highly recommended)
* **NOTE:** Upgrading from version 0.6.1 and newer only, is supported. Previous version must upgrade to 0.6.1 before upgrading to the current version.

== Changelog ==

[Complete Changelog can be found here.](https://connections-pro.com/changelog/)

= 8.25.1 08/06/2018 =
* BUG: Add limit parameter to `cnOutput::getDateBlock()` to correct index not defined PHP notice.
* DEV: phpDoc correction.

= 8.25 08/01/2018 =
* TWEAK: Refactor the Manage admin page to utilize `cnEntryDates::render()`.
* TWEAK: Refactor `cnEntry_Output::getDateBlock()` to utilize the `cnEntry_Dates` objects `render()` method using templates.
* TWEAK: Remove unused parameters from methods in cnOutput.
* BUG: Correct a couple typos in `cnEntry_Dates::render()`.
* I18N: Update POT file.
* I18N: Update MO files.
* DEV: phpDoc correction.

= 8.24 07/27/2018 =
* NEW: Introduce `cnString::replaceFirst()` and `cnString::replaceLast()`.
* TWEAK: Refactor `cnEntry` to utilize `cnEntry_Dates`.
* TWEAK: Refactor `cnShortcode::single()` to utilize `cnString::replaceFirst()`.
* TWEAK: Use `wp_kses_post()` instead of `esc_html()` to display setting descriptions so HTML such as links can be used.
* TWEAK: Add missing link to documentation in the content block setting descriptions.
* I18N: Update POT file.
* I18N: Update MO files.
* OTHER: Correct copy/paste error within some inline code comments.

= 8.23 07/23/2018 =
* BUG: Honor the `$saving` parameter when querying entry data from its object cache.

= 8.22 07/18/2018 =
* FEATURE: Introduce the Date Fieldset configuration options.
* NEW: Introduce `cnEntry_Dates()` and `cnEntry_Date()`.
* TWEAK: Init a new cnMessenger object instead of stdClass when creating "dummy" objects for the messenger fieldset.
* TWEAK: Ensure `$screen` is instance of WP_Screen before accessing methods.
* TWEAK Make data parameter in cnAddress, cnPhone, cnEmail_Address, cnLink and cnMessenger optional. Default to array.
* TWEAK: Init each entry template field with the corresponding object instead of a generic stdClass.
* TWEAK: If there are no active entry types, use the default entry type.
* BUG: Get default messenger type instead of default email type in the messenger fieldset.
* BUG: Sanitize messenger user ID correctly.
* OTHER: Add trailing comma to array.
* DEV: phpDoc corrections.

= 8.21 06/11/2018 =
* TWEAK: Remove usage of `$connections` global from `cnOutput::vcard()`.
* TWEAK: Update `cnText_Domain::create()` to accept the plugin basename parameter.
* TWEAK: Tweak the `cnText_Domain::register()` `$priority` parameter to accept a value of `load` so the text domain is loaded instead of registered via the `plugins_loaded` action hook.
* TWEAK: Requirements check for tested up to compatibility only compares major.minor ignoring release version.
* TWEAK: Remove unused parameters from methods in cnOutput.
* TWEAK: Refactor `cnEntry_Output::getLinkBlock()` to utilize the `cnEntry_Links` objects `render()` method using templates.
* I18N: Add translation text context for person "Title" and link "Title" so the can be translated individually.
* COMPATIBILITY: Compatibility tweak for the MayaShop theme. Remove the filter being applied to the `clean_url` being applied by the theme.
* BUG: `cnOutput::renderMetaBlock()` should echo, not return.
* DEV: Some phpDoc cleanup.

= 8.20 06/01/2018 =
* NEW: Load plugin only if the current environment passes the requirements checks.
* NEW: Bump minimum WP version to 4.5.3.
* NEW: Introduce cnRequirements_Check.
* TWEAK: Disable the no shortcode 404 trigger. Once again foiled by visual page builders!
* TWEAK: Add the address property to cnLink for backwards compatibility.
* TWEAK: Strip tags when displaying the upgrade notice.
* TWEAK: Tweak regex for parsing the extensions changelog text to be compatible with EDD-SL >= 3.6.
* TWEAK: Add Settings heading to the settings admin page.
* TWEAK: Slight refactor of cnText_Domain to make it plugin-agnostic, not rely on plugin constants, so it can be utilized by add-ons to reduce code duplication.
* BUG: If link title is blank, use the link URL.
* BUG: Remove extra div/unclosed tags on the manage admin page.
* COMPATIBILITY: Divi, disable the "Grab the first post image" option on pages where the `[connections]` shortcode exists.

= 8.19.1 05/09/2018 =
* BUG: If link title is blank, use the link URL.
* BUG: Add the address property to cnLink for backwards compatibility.

= 8.19 05/02/2018 =
* NEW: Introduce the `cn_customizer_image_options` filter.
* NEW: Introduce `cnEntry_Links()` and `cnLink()`.
* NEW: Introduce helper methods `maybeUnserialize()` and `fromMaybeSerialized()` to ` cnEntry_Object_Collection`.
* NEW: Introduce `cnEntry_Image`.
* TWEAK: Ensure link URL is a string before prefixing it and passing it to the objects property.
* TWEAK: Update cnLink with helper methods for attaching a link to an image and add helper methods to get which image the link might be attached to.
* TWEAK: Update cnEntry_Links, added support to filter links attached to images.
* TWEAK: Move the messenger back compatibility logic from `cnEntry` to `cnEntry_Messenger_IDs`.
* TWEAK: Refactor `cnEntry` to utilize `cnEntry_Links`.
* TWEAK: Init the `cnEntry_Image` object and refactor code, moving the legacy image processing logic to `cnEntry_Image`.
* TWEAK: If shortcode is not found in post content and a registered query var is detected, trigger a 404.
* DEV: phpDoc updates.
* DEV: Remove dead commented out code from constructor in `cnEntry`.
* DEV: Remove unused method properties in `cnEntry`.
* DEV: Remove unused private method in `cnEntry`.
* DEV: Remove unused properties in `cnEntry`.
* DEV: Change `satooshi/php-coveralls` to `php-coveralls/php-coveralls` in composer.json.
* DEV: Update `php-coveralls/php-coveralls` required version.

= 8.18 04/20/2018 =
* TWEAK: Switch all `is_a()` instances of to `instanceof`.
* TWEAK: Update teh jQuery Validate library to 1.17.0.
* TWEAK: Add option to `cnOutput::getImage()` to enable the logo/photo to be a entry permalink unless overridden by an assigned link.
* TWEAK: Update the Default Entry Card template so the logo/photo will be a permalink to the entry.
* TWEAK: Update the Profile template so the logo/photo will be a permalink to the entry.
* TWEAK: Rename `cnSEO::trigger404()` to `cnSEO::trigger404_entryNotFound()`.
* OTHER: Correct misspelling.
* DEV: phpDoc corrections.
* DEV: Remove unused variables.

= 8.17 04/13/2018 =
* FEATURE: Add link fieldset configuration options.
* TWEAK: Change class constant access syntax to be compatible with php5.3.
* TWEAK: Minor tweak to logic to ensure the preferred array value does not create a new messenger ID object when updating from array.
* TWEAK: Create instance of cnPhone instead of stdClass when creating a new phone number object when creating a "dummy" placeholder object for the phone fieldset.
* TWEAK: Create instance of cnEmail_Address instead of stdClass when creating a new email address object when creating a "dummy" placeholder object for the email fieldset.
* TWEAK: Set the `cnEntry::getLinks()` default value for type to query to NULL instead of the registered core types so all links will be queried vs. only the registered types.
* TWEAK: Change default date format of `cnEntry::getFormattedTimeStamp()` to use the WordPress default date format set by the user in the settings.
* TWEAK: When saving/updating an entry, the added date time and updated date time should be saved in UTC.
* TWEAK: Update various spots in the code to account that the last updated and date added timestamps are in UTC so they will properly be cconverted into the current user's timezone.
* TWEAK: Change `cnEntry::getDateAdded()` to use the user's defined date format from the WP settings.
* TWEAK: Add time to `cnEntry::getFormattedTimeStamp()` default date format. Default to user's defined date time format from the WP settings.
* TWEAK: Add time to `cnEntry::getDateAdded()` default date format. Default to user's defined date time format from the WP settings.
* TWEAK: Remove the hardcoded date time formats used on the Manage admin page so they will display in the users defined date time format in the WP settings.
* TWEAK: Ensure `cnEntry::getBio()` and `cnEntry::getNotes()` only return strings.
* BUG: Correct PHP index not found notice.
* BUG: The messenger fieldset was not updated to honor the fieldset settings!
* BUG: Version should be string.
* OTHER: Remove extra spaces.
* OTHER: Remove todo in cnEntry.
* OTHER: Remove extra tabs and align `span` tags.
* OTHER: Remove trailing spaces.
* OTHER: Remove extra spaces.
* I18N: Correct string so it can be translated.
* DEV: phpDoc corrections.
* DEV: Remove some commented out debug code.

= 8.16 03/30/2018 =
* FEATURE: Introduce the Instant Messenger Fieldset configuration options.
* NEW: Introduce `cnEntry_Messenger_IDs` and `cnMessenger` objects.
* NEW: Introduce `cnText_Domain::register()`.
* TWEAK: Add abstract constructor to `cnEntry_Collection_Item`.
* TWEAK: Add method `create()` to `cnEntry_Collection_Item`.
* TWEAK: Remove method `create()` from `cnPhone` and `cnEmail` to remove code duplication.
* TWEAK: Refactor `cnEntry::getIm()` and `cnEntry::setIm()` to utilize the `cnEntry_Messenger_IDs` object.
* TWEAK:Refactor `cnEntry_Output::getImBlock()` to utilize the `cnEntry_Messenger_IDs` objects `render()` method using templates.
* TWEAK: Add VERSION constant to the core plugin class to store the plugin version.
* TWEAK: Use class VERSION constant to set the global version constant for the plugin version.
* TWEAK: Deprecate `cnText_Domain::create()`.
* TWEAK: Use `cnText_Domain::register()` instead of `cnText_Domain::create()`.
* TWEAK: Add a few class variables and helper methods to get the plugin path, url and basename.
* TWEAK: Use the helper methods to set the global constants for the plugin path, url and basename.
* BUG: Phone number was being sanitized as a street address, corrected so it is sanitized as a phone number.
* OTHER: Correct misspelling.
* DEV: Correct inline documentation.
* DEV: phpDoc corrections.
* DEV: Correct code indents.
* DEV: Add phpDoc block to `ConnectionsLoad::hooks()`.

= 8.15 03/24/2018 =
* BUG: Ensure `cnEntry_Email_Addresses` is properly initialized when adding new entry.

= 8.14 03/23/2018 =
* NEW: Introduce `cnEntry_Email_Addresses` and `cnEmail_Address`.
* TWEAK: Use `array_replace()` instead of `array_merge()` when setting the order of a sortable settings input list.
* TWEAK: Refactor `cnEntry::getEmailAddresses()` and `cnEntry::setEmailAddresses()` to utilize `cnEntry_Email_Addresses` and `cnEmail_Adress`.
* TWEAK: Refactor `cnEntry_Output::getEmailAddressBlock()` to utilize `cnEntry_Email_Addresses::render()`.
* TWEAK: Update manage admin page to utilize the new email addresses template.
* BUG: Ensure integer is passed to `gmdate()`.
* BUG: The method `cnRetrieve::entries()` is not static, but was called statically.
* OTHER: Add the new Certifications add on to the readme.txt file.
* OTHER: Correct the version changelog section.
* DEV: Correct phpdoc alignment.
* DEV: phpDoc corrections.

= 8.13 03/09/2018 =
* FEATURE: Add new option to the Connections : Manage admin page Screen Option to allow the user to choose between the entry logo or photo as the thumbail.
* NEW: Introduce `cnUser::getMeta()` and `cnUser::setMeta()`.
* NEW: Introduce `cnUser::getScreenOptions()` and `cnUser::setScreenOptions()`.
* NEW: Introduce `cnUser::getScreenOption()` and `cnUser::setScreenOption()`.
* TWEAK: Refactor `cnUser::getFilterPage()` and `cnUser::setFilterPage()` to use `cnUser::getScreenOption()` and  `cnUser::setScreenOption()` respectively and then deprecate those methods.
* TWEAK: Add `connectionsLoad::$user` as reference to `connectionsLoad::$currentUser`.
* OTHER: Update the Screen Options library from version 1.3 to 1.4.
* OTHER: Update Chosen library from 1.7.0 to 1.8.3.
* I18N: Update POT file.
* I18N: Update MO files.
* DEV: Update package.json.
* DEV: phpDoc corrections.

= 8.12 02/19/2018 =
* NEW: Introduce several new timezone helper methods in cnDate.
* TWEAK: Add options to the `cnRetrieve::upcoming()` method to suport whether or not to check user caps and from timestamp.
* TWEAK: Add option to `cnRetrieve::entries()` to support whether or not to check user caps.
* TWEAK: Remove a bunch of unused and unnecessary methods from cnDate.
* TWEAK: Use `cnDate::getWPUTCOffset()` helper method in `cnEntry_vCard::getUTCOffset()`.
* TWEAK: Cast result of date('I') to int.
* BUG: The `wp_script_is()` requires a handle to check.
* BUG: Correct array to string conversion PHP notice.
* DEV: phpDoc corrections in cnDate.

= 8.11 02/05/2018 =
* NEW: Add support for the plugin bannerS in plugin info REST API responses.
* NEW: Add support for the plugin iconS in plugin info REST API responses.
* NEW: Add support for opting into beta versions of the installed addons.
* NEW: Introduce cnPlugn_Updater::maybe_unserialize_response().
* NEW: Introduce cnText_Domain.
* TWEAK: Check for DOING_AJAX when adjusting the addon update check and status check.
* TWEAK: Clean plugin cache on addon activate/deactivate.
* TWEAK: When doing addon status check use the same timeout as used during update checks when on the WP Updates admin page.
* TWEAK: Update addon statuses after doing an update check.
* TWEAK: Clean the plugin cache before running the addon status check.
* TWEAK: Change the priority of addon status check to 9 on the WP Plugins admin page so it runs before the addon update check.
* TWEAK: Utilize cnText_Domain to load the plugin translation files.
* BUG: Ensure the $atts variable is an array before setting values when viewing all.
* DEV: phpDoc corrections.
* DEV: Update plugin header.

= 8.10 01/26/2018 =
* NEW: Introduce abstract class cnEntry_Object_Collection.
* NEW: Introduce abstract class cnEntry_Collection_Item.
* NEW: Introduce class cnEntry_Phone_Numbers.
* NEW: Introduce class cnPhone.
* NEW: Introduce cnCSV_Batch_Export_All::getFields().
* NEW: Create the phone tempalte files for hCard and the manage admin page.
* NEW: Complete refactor of phone number model using cnEntry_Phone_Numbers and cnPhone objects.
* TWEAK: Ensure upcoming dates are translated thru date_i18n().
* TWEAK: Use the default address type rather than "other" when constructing a new address if type was not supplied.
* TWEAK: Add phone number to the sanitize field method.
* TWEAK: Make cnCSV_Batch_Export::getTerms() a public method.
* TWEAK: Refactor cnCSV_Batch_Export_All and introduce filters for plugins to hook into.
* TWEAK: PHP7.2 notice fix.
* TWEAK: Rename "Field Configuration" settings tab to "Fieldset Configuration" for consistency.
* TWEAK: Add "Fieldset" to the settings sections title for consistency.
* TWEAK: Add the missing "Link Fieldset" settings section.
* TWEAK: cnEntry property should not be init'd as a string since it is an cnEntry_Addresses object.
* DEV: phpDoc corrections.

= 8.9 01/12/2018 =
* FEATURE: Add email fieldset configuration options.
* TWEAK: Minor tweaks to CN_parseCSV::parse_string() and CN_parseCSV::unparse() to use column indexes rather than column header names as the array index to allow duplicate column names in the source CSV file.
* BUG: Link title and url fields were not being sanitized.
* DEV: phpDoc corrections.

= 8.8 12/22/2017 =
* FEATURE: Add phone fieldset configuration options.
* TWEAK: Ensure `jquery-form` is registered, seems some plugin/theme is unregistering this core WP script.
* TWEAK: Tweak to ensure Say What text changes can be applied to address type labels.
* TWEAK: cnOptions::getRegisteredAddressTypes()` should return all active and inactive address types.
* TWEAK: Deprecated `cnOptions::getDefaultAddressValues() `should return `cnOptions::getAddressTypesOptions()`.
* TWEAK: Minor CSS tweak to admin widget title, setting min height.
* BUG: Fix PHP Warning: natsort() expects parameter 1 to be array, null given.

= 8.7.1 12/13/2017 =
* TWEAK: Use `strtolower()` instead of `mb_strtolower()`.
* TWEAK: Use `strtoupper()` instead of `mb_strtoupper()`.
* TWEAK: Do not use ternary shorthand, requires PHP > 5.3.
* BUG: Update minified CSS/JS files.
* BUG: Remove placeholder string in settings.
* DEV: Add couple phpDoc references.

= 8.7 12/12/2017 =
* FEATURE: Introduce field configuration options for the Publish, Name and Address field sets.
* NEW: Add United Kingdom counties to cnGEO.
* NEW: Introduce `cnGEO::getRegionName()`.
* NEW: Introduce cnCountries.
* NEW: Introduce the WP REST API countries endpoint/routes.
* NEW: Add support for sortable/repeatable checklist fields in the Settings API.
* TWEAK: Increase CSS enqueue priority to load last.
* TWEAK: Remove the Enfold theme comapatibility hack as it no longer seems necessary after changing the CSS load priority.
* TWEAK: Ensure minheight of the search submit button is set to auto to try to override themes which insist on setting a global minheight on submit form fields.
* TWEAK: Make img src URL protocol relative.
* TWEAK: Make `cn_manage_{taxonomy}_custom_column` hook an action instead of filter.
* TWEAK: Add methods to cnCountry to pull data from the Rinvex\Country library and update existing calls to it to make them compatible to the new country attributs structure.
* TWEAK: Refactor cnGeo to utilize cnCountries, deprecating many of the region specific methods.
* TWEAK: Make `cnGEO::getRegionName()` a public static method matching the est of the members in the class.
* TWEAK: Do not show labels for hidden text inputs.
* TWEAK: Add support for the data attribute in `cnHTML::input()`.
* BUG: Check for page hook properties one ata time as they are added to the filter array ro prevent PHP warning notices from being generated on multisite.
* BUG: Check to ensure varaiable is array before using in a foreach loop to prevent a PHP warning.
* BUG: Correct `Illegal string offset` and `Cannot create references to/from string offsets` PHP errors when saving user meta.
* DEV: Include the Rinvex\Country library.

= 8.6.12 11/01/2017 =
* NEW: Introduce support for custom taxonomies.
* NEW: Introduce the `cn_image_editors` filter.
* NEW: Introduce the `cn_entry_directory_homepage` filter.
* NEW: Introduce the `cn_image_link` and `cn_image_link-{type}` filters.
* NEW: Introduce the `cn_entry_output_category_items` filter.
* TWEAK: Some code cleanup of the output for social media networks icons.
* TWEAK: Add some RTL CSS in its own CSS file to be conditionally loaded.
* BUG: When exporting all, make sure to attempt to JSON decode the option column before access its value.
* BUG: Drop the `slug` index on the connections_terms table.
* BUG: Remove debug code from the CSV export all output.
* BUG: Correct bug which could prevent the logo/photo URL from being exported.
* OTHER: Add reference to the Local Time extension in the readme.txt file.
* OTHER: Replace `http` with `https` for wordpress.org and connections-pro.com domain links.
* DEV: phpDoc corrections.
* DEV: Add curly brackets to a variable variable for better code clarity.

= 8.6.11 09/01/2017 =
* BUG: Fix to allow `0` minutes and seconds by improving check for existing key and ensure it is not false after parsing a datetime format before merging value.
* BUG: If the parsed datetime is in 12 hour format, properly convert the time to 24 hour format.

= 8.6.10 08/25/2017 =
* TWEAK: Rename the getGMTOffset method in cnEntry_vCard to better describe its function.
* TWEAK: Add Angola and its provinces.
* TWEAK: Tweak to logic to determine if a canonical redirect should be processed or not.
* TWEAK: Cache requests to the Google Maps Time Zone API for 24 hours.
* TWEAK: Add `get_utc_offset()` and `utc_offset()` methods to cnTimezone.
* TWEAK: Add `getTimezone()` to cnAddress which utilizes cnGoogleMapsTimezone().
* TWEAK: Update `cnRetrieve::setQueryVisibility()` to return a query selector of none if the current user does not have the required capabilities to view the object.
* TWEAK: Update `cnRetrieve::upcoming()` to respect the visibility status of the date based on the current user's capabilities.
* TWEAK: Update the `[upcoming_list]` shortcode to utilize `cnRetrieve::upcoming()` instead of custom query in the shortcode callback to standardize results globally across the core plugin.
* BUG: Correct the return value of cnTimezone::get_raw_offset().
* BUG: Ensure property exists before using it in cnGoogleMapsTimeZone::queryTimeZone().
* BUG: Function should be static.
* DEV: Add a few missing phpDoc blocks.

[Complete Changelog can be found here.](https://connections-pro.com/changelog/)

== Upgrade Notice ==

= 8.6.10 =
It is recommended to backup before updating. Requires WordPress >= 4.4.

= 8.6.11 =
It is recommended to backup before updating. Requires WordPress >= 4.4.

= 8.6.12 =
It is recommended to backup before updating. Requires WordPress >= 4.4.

= 8.7 =
It is recommended to backup before updating. Requires WordPress >= 4.4.

= 8.7.1 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.8 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.9 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.10 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.11 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.12 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.13 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.14 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.15 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.16 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.17 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.18 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.19 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.19.1 =
It is recommended to backup before updating. Requires WordPress >= 4.4 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.20 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.21 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.22 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.23 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.24 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.25 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.

= 8.25.1 =
It is recommended to backup before updating. Requires WordPress >= 4.5.3 and PHP >= 5.3. PHP version >= 7.1 recommended.