-
Notifications
You must be signed in to change notification settings - Fork 18
/
README.txt
599 lines (508 loc) · 41.7 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
=== Connections Business Directory ===
Contributors: [email protected]
Donate link: https://connections-pro.com/
Tags: business directory, member directory,staff directory, chamber of commerce, church directory
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.0
Stable tag: 10.4.66
License: GPLv2 or later
License URI: https://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://wordpress.org/support/plugin/connections/) | [Templates](https://connections-pro.com/templates/) | [Extensions](https://connections-pro.com/extensions/)
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 =
* **[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.
* Compatible with all themes including popular themes such as Avada, Divi, Enfold and OceanWP.
* Compatible with most popular page builders such as Elementor, Beaver Builder, Brizy, Visual Composer, Fusion, SiteOrigin, etc...
* **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.
* [Supports the native sitemaps](https://connections-pro.com/connections-10-0-seo-sitemaps/) feature available in WordPress versions 5.5 and newer.
* [Yoast SEO and Rank Math sitemaps integration.](https://connections-pro.com/connections-10-1-seo-sitemaps-integrations/)
* **Event Logging** Integrates with the [Simple History plugin](https://wordpress.org/plugins/simple-history/); logging directory related events such as creating a new entry, modifying an entry, and deleting an entry.
* Supports the WordPress Block (Gutenberg) Editor with the following blocks.
* [Carousel Block](https://connections-pro.com/documentation/block/carousel/) :: Display your directory as a carousel.
* [Directory Block](https://connections-pro.com/documentation/block/directory/) :: Use this block to embed your directory in a page.
* [Team Block](https://connections-pro.com/documentation/block/team/) :: It's easy to use Connections to build your team page! Team Block is a full-featured block with multiple layout styles. While premium team plugins can set you back $20 or more, Team Block is free for all Connections users.
* [Upcoming List Block](https://connections-pro.com/documentation/block/upcoming-list/) :: Use this block to display an upcoming list of anniversaries, birthdays or other events.
* A growing selection of Content Blocks:
* [Related Entries](https://connections-pro.com/connections-9-8-related-content-blocks/):: Display related Entries in a mobile responsive carousel.
* [Nearby Entries](https://connections-pro.com/connections-9-9-nearby-entries-content-block/):: Increase discoverability of Entries by displaying nearby Entries in a mobile responsive carousel.
* [Recently Viewed](https://connections-pro.com/connections-9-10-recently-viewed-entries-content-blocks/):: A list a directory Entries the user has recently viewed.
* Last Viewed:: The last directory Entry the user viewed.
* Frontend Entry Management:: Management options include a quick link to edit the Entry and a Delete option.
* Entry Meta:: Display details such as when the Entry was added nad last modified and by whom.
* 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, instant messenger, 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/).
* **[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 spambots.
* [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 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/documentation/install/) available that'll walk you through 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:** >= 2.3
* **PHP version:** >= 5.6.20 ( 7.1 is highly recommended)
== Changelog ==
[Complete Changelog can be found here.](https://connections-pro.com/changelog/)
= 10.4.66 11/13/2024 =
* FEATURE: Update the Carousel Block to include an option to link to the Directory Entry Profile.
* NEW: Introduce `Field\Term_Radio_Group`.
* NEW: Introduce `\Entry\Functions::email()` and `\Entry\Functions::phone()`.
* NEW: Introduce `\Utility\_::maybeEcho()`.
* NEW: Introduce `cnRetrieve::countries()` and `cnRetrieve::regions()`.
* NEW: Add the search by country and regions (state) to the advanced search fields.
* TWEAK: Slight refactor of `\Form\Search::keywordField`.
* TWEAK: Add `nocache` to login URL.
* TWEAK: Utilize native PHP `DateTime::createFromFormat()` instead of the backward support polyfill.
* TWEAK: Add `_wpnonce` to the user login form.
* BUG: Do not render the excerpt `div` if there is no excerpt text.
* BUG: Using ${var} in strings is deprecated, use {$var} instead.
* OTHER: Correct misspellings.
* OTHER: Bump Tested up to in README.TXT.
* OTHER: Limit README.txt tags to 5.
* OTHER: Reflow @todo.
* OTHER: Add `@todo`.
* OTHER: Correct phpDoc typo.
* OTHER: phpDoc corrections.
* I18N: Update Italian translation.
* WPCS: Remove trailing space.
* WPCS: Correct inline code comment.
* WPCS: There must be exactly one blank line before the tags in a doc comment.
= 10.4.65 02/28/2024 =
* NEW: Introduce `Field\Term_Checkbox_Group`.
* TWEAK: Make `\Form\Field\Select_Term::setQueryParameters()` chainable.
* TWEAK: Declare strict types in `\Form\Field\Checkbox_Group`.
* TWEAK: Add parameter and return types to `\Form\Field\Checkbox_Group`.
* TWEAK: Rename `\Form\Field\Select_Term` to `\Form\Field\Term_Select`.
* TWEAK: Remove unnecessary variable.
* TWEAK: In `\Form\Field\Input` create `Label` object only when the `label` attribute is not empty.
* TWEAK: Apply the Form field label only if the attribute is an instance of `\Form\Field\Label`.
* TWEAK: Rename object parameters to match the parameter name of the overridden class method.
* TWEAK: Refactor `Field\Term_Select` to match `Field\Term_Checkbox_Group` for consistency.
* TWEAK: Update `\Form\Search\` to include taxonomy term select dropdown fields.
* TWEAK: Move logic from `\cnRetrieve::parseRequest()` to `\Request::parse()` for the `cn-cat` and `cn-cat-slug` query variables.
* BUG: Ensure `label` attributes are preserved when applying the field label position.
* DEV: phpDoc corrections.
* DEV: phpDoc updates.
* DEV: Add phpDoc to `\Form\Field\Checkbox_Group`.
= 10.4.64 02/19/2024 =
* NEW: Introduce `Fields\Select_Term`.
* NEW: Introduce `\Form\Field\Select::getOptions()` and `\Form\Field\Select::hasOptions`.
* TWEAK: Remove BOM when importing a Category CSV file.
* TWEAK: Change the variable `$file` initial value from `null` to an empty string.
* TWEAK: Increase the number of lines of the CSV file that is utilized to automatically determine the CSV enclosure character.
* TWEAK: Do not render form header and footer sections if they do not contain any content.
* TWEAK: Remove unused import from `\Form\Field\Select`.
* TWEAK: Remove unnecessary `\Form\Field\Select::walkOptions()`.
* TWEAK: Add the `$filter_by_item` default string when registering a taxonomy.
* TWEAK: `Field\Select` extend `Input` instead of `Field`.
* TWEAK: Replace legacy `cnTemplatePart::walker('term-select')` with modern `Field\Select_Term`.
* TWEAK: Move the loading of the term walkers to the autoloader and files into the `Walker` folder.
* OTHER: Correct misspellings.
* DEV: phpDoc corrections.
* DEV: Add return type declaration to `\Form\Field\Select::getFieldHTML().`
* DEV: Add phpDoc to `\Form\Field\Select`.
* DEV: Rename variable.
= 10.4.63 02/06/2024 =
* FEATURE: Introduce `core uninstall`.
* TWEAK: Register the setting section and field for the "Uninstall" setting option. Trigger a browser prompt form confirmation.
* TWEAK: Make `initOptions()` public.
* TWEAK: Remove manual loading of the cnRole class as it is already included in the autoloader classmap.
* TWEAK: Move the `Connections_Directory()` global function from the `Connections_Directory` class to the base plugin file.
* TWEAK: Move the Activate/Deactivate hooks to their own class/file.
* TWEAK: Refactor `uninstall.php` to delete the plugin data, options, and tables if the option is enabled in the settings.
* BUG: Prevent date from being displayed twice in the Recently Added/Modified Dashboard admin widgets.
* OTHER: Correct misspellings.
* OTHER: Add missing trailing period.
* DEV: phpDoc corrections.
* DEV: phpDoc updates.
= 10.4.62 01/29/2024 =
* FEATURE: Introduce the Settings Reset tool.
* FEATURE: WP-CLI: Introduce `settings <command>`.
* TWEAK: Ensure Dashboard Awaiting Moderation, Recently Added, and Recently Modified widgets use the site options for the date and time format.
* TWEAK: Make `cnSettingsAPI::getAll()` public.
* TWEAK: Reset the confirmation text field in the Database Reset tool after both error and success.
* TWEAK: Reset `cnEntry_HTML::getCategoryBlock()` to its default parameters after each entry render.
* DEV: phpDoc corrections.
* DEV: phpDoc updates.
* ESLint: corrections.
* WP-CLI: Add success messages to the `tables` commands.
= 10.4.61 01/19/2024 =
* FEATURE: Introduce the WP-CLI commands `core version` and `tables <command>`.
* FEATURE: Introduce the Database Reset Tool.
* NEW: Introduce `\Request::isCLI()`.
* TWEAK: Replace deprecated `cnShortcode::addFilterRegistry()` calls with `\Template\Hook_Transient::add()`.
* TWEAK: Use instance of `Term` in `\cnTemplatePart::categoryBreadcrumb()`.
* TWEAK: Route to the PHP error log, developer deprecated notices when running WP-CLI commands.
* TWEAK: Add JSDoc for global variable to enable code completion.
* BUG: Remove empty strings from the page title pieces to prevent leading/trailing page title separators from displaying.
* OTHER: Correct misspellings.
* DEV: phpDoc corrections.
* DEV: Add comment to `phpcs.xml`.
* WPCS: Inline comments must end in full-stops, exclamation marks, or question marks.
* WPCS: Spaces must be used for mid-line alignment; tabs are not allowed.
* WPCS: Disable `PEAR.NamingConventions.ValidClassName.StartWithCapital` and `WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedClassFound`.
* WPCS: Ignore WPCS flags in `Utility\_deprecated`.
= 10.4.60 12/22/2023 =
* NEW: Introduce `CN_Walker_Term_Select_List_Enhanced::generateSelectAllOption()`.
* NEW: Introduce `CN_Walker_Term_Select_List_Enhanced::generateSelectNoneOption()`.
* TWEAK: Adjust Rank Math robots meta, set noindex on term pages.
* TWEAK: Utilize the `wpseo_robots_array` filter to improve Yoast SEO integration by setting `noindex` on the pg and term slug pages.
* TWEAK: Use strict comparison.
* TWEAK: Refactor `CN_Walker_Term_Select_List_Enhanced::render()` to utilize `generateSelectAllOption()`.
* TWEAK: Refactor `CN_Walker_Term_Select_List_Enhanced::render()` to utilize `generateSelectNoneOption()`.
* TWEAK: Simplify string concatenation.
* TWEAK: Update max tested WP version.
* OTHER: Correct misspelling.
* DEV: Remove unnecessary trailing semi-colon.
* DEV: Remove @noinspection tag.
* DEV: phpDoc updates.
* DEV: phpDoc corrections.
* DEV: Remove WPCS exclusions.
* DEV: Remove commented out unused code.
* WPCS: Use the __DIR__ constant instead of calling dirname(__FILE__) (PHP >= 5.3).
* WPCS: Update properties for `Universal.WhiteSpace.PrecisionAlignment`.
* WPCS: Universal.WhiteSpace.CommaSpacing.TooMuchSpaceAfter.
* WPCS: Universal.WhiteSpace.CommaSpacing.SpaceBefore.
* WPCS: Generic.WhiteSpace.IncrementDecrementSpacing.SpaceAfterDecrement.
* WPCS: Squiz.Commenting.FunctionComment.ParamCommentFullStop.
* WPCS: Generic.WhiteSpace.LanguageConstructSpacing.IncorrectSingle and Squiz.Strings.ConcatenationSpacing.PaddingFound.
* WPCS: Generic.WhiteSpace.IncrementDecrementSpacing.SpaceAfterIncrement.
* WPCS: Universal.CodeAnalysis.StaticInFinalClass.NewInstance.
* WPCS: Unnecessary "echo sprintf(...)" found. Use "printf(...)" instead.
* WPCS: The DEFAULT body must start on the line following the statement.
* WPCS: Universal.WhiteSpace.CommaSpacing.SpaceBefore.
* WPCS: Expected 1 space before the array closer in a single line array.
* WPCS: Expected 1 space after FUNCTION keyword; 0 found.
* WPCS: Function closing brace must go on the next line following the body; found 1 blank lines before brace.
* WPCS: Expected 1 blank line at end of file.
* WPCS: The closing brace for the class must go on the next line after the body.
* WPCS: Universal.WhiteSpace.CommaSpacing.SpaceBefore.
* WPCS: Use "self" instead of "static" when using late static binding in a final OO construct.
* WPCS: Opening statement of multi-line function call not indented correctly.
* WPCS: The file-level docblock must follow the opening PHP tag in the file header.
= 10.4.59 12/01/2023 =
* NEW: Introduce `Request::isSingle()`.
* TWEAK: Replace `cnEntry_Action` with `\Hook\Action\Admin_Bar::addEditEntry()`.
* TWEAK: Refactor `\Form\Field\Option` to support the `class` and `style` attributes.
* TWEAK: Refactor `CN_Walker_Term_Select_List_Enhanced::do_el()` to utilize `\Form\Field\Option`.
* TWEAK: Refactor `CN_Walker_Term_Select_List_Enhanced` to ensure inherited method parameter names match.
* TWEAK: Remove unused import.
* DEV: phpDoc corrections.
* DEV: phpDoc updates.
* WPCS: Add method return type.
* WPCS: It is recommended not to use reserved keyword "default" as function parameter name. Found: $default.
* WPCS: Add missing parameter type declaration.
* WPCS: Exclude a few WP VOP Go sniffs.
* WPCS: Inline comments must end in full-stops, exclamation marks, or question marks.
= 10.4.58 11/27/2023 =
* TWEAK: Delete extra trailing period from inline code comment.
* OTHER: Correct misspellings.
* OTHER: Update the dist files.
* WPCS: A single space must follow the `function` keyword.
* WPCS: Update phpcs ignore.
* WPCS: Spaces must be used for mid-line alignment; tabs are not allowed.
* DEV: Update WPCS to version 3.0.
* DEV: npm audit fix.
* DEV: Update webpack.
* DEV: Add the custom role capability properties to phpcs.xml.
* DEV: phpDoc corrections.
= 10.4.57 11/17/2023 =
* NEW: Introduce `CN_Walker_Term_Select_List_Enhanced::generatePlaceholder()`.
* TWEAK: Ensure the `\Simple_History\Simple_History` class exists before adding the Simple History logger registration hook to prevent possible fatal errors when older version of Simple History are installed.
* TWEAK: Ensure the core WP default filters exists for WP User authentication during the REST API request.
* TWEAK: Simply direct access exit.
* TWEAK: Refactor `\Form\Field\Option::prepareAttributes()` to process custom attributes.
* TWEAK: Refactor `CN_Walker_Term_Select_List_Enhanced::render()` to utilize `generatePlaceholder()`.
= 10.4.56 11/10/2023 =
* BUG: Correct parameter used when defining the "remember me" checkbox in the login form.
* BUG: Prevent fatal PHP error if `wp_signon()` returns and instance of `WP_Error` instead of an instance of `WP_User`.
= 10.4.55 10/26/2023 =
* NEW: Introduce `Shortcode` abstract class to reduce code duplication when registering shortcodes with WordPress.
* TWEAK: Replace instances of `strip_tags()` with `wp_strip_all_tags()`.
* TWEAK: Add an `is_string()` check to `_string::stripTags()` to help ensure no PHP deprecation notices are thrown.
* TWEAK: Utilize `_string::stripTags()` instead of `strip_tags()` to help ensure no PHP deprecations notices.
* TWEAK: Remove unused commented out code referencing a method long removed in `cnRetrieve`.
* TWEAK: Remove use of deprecated `cnShortcode::addFilterRegistry()` calls in `Shortcode\Entry`.
* TWEAK: Refactor `Shortcode\Entry` to utilize `Shortcode` to reduce code duplication.
* BUG: Do not overwrite the `category` shortcode value if the `cn-cat` request variable is empty.
* DEV: phpDoc corrections.
= 10.4.54 10/20/2023 =
* BUG: Use `Request::setVar()` to reset the pagination value when the offset count is greater than the total row count to prevent a potential query loop and PHP fatal error.
= 10.4.53 10/16/2023 =
* FEATURE: Add integration and support for the [Simple History plugin](https://wordpress.org/plugins/simple-history/).
* TWEAK: Pass the `$args` parameter to the `cn_edit_terms` filter.
* TWEAK: Pass the `$args` parameter to the `cn_edit_terms` filter.
* BUG: Merge provided taxonomy labels with the default labels.
* OTHER: Correct misspellings.
= 10.4.52 09/29/2023 =
* TWEAK: Add webp as a valid image type when validating image uploads.
* BUG: Revert specificity CSS for icons to be more targeted to the Connections Brandicons (Icomoon).
= 10.4.51 09/28/2023 =
* TWEAK: Update Twitter to reflect the brand change to 𝕏. Add Google Scholar, ORCiD, ResearchGate, and 𝕏.
* TWEAK: Allow the Number metabox field type to be registered for the keyword search field.
* TWEAK: Apply CSS Lint style fixes.
* BUG: Ensure the `number` metabox field value is properly sanitized.
* DEV: Update the `dist` assets.
= 10.4.50 09/08/2023 =
* NEW: Introduce the `number` field type in the Metabox API.
* NEW: Introduce `Request\Input::setDefault()`.
* NEW: Introduce `User_Login::maybeRedirect()`.
* TWEAK: Ensure both the username and user email request values are sanitized before user.
* TWEAK: Move the permission check to the `permission_callback` for the `account/login` REST API endpoint.
* TWEAK: Ensure the `remember` parameter for the login form is properly coerced into a boolean.
* TWEAK: Remove unnecessary user login check before user sign on.
* TWEAK: Refactor the `account/login` endpoint to support the `login_redirect` filter.
* TWEAK: Rename the `redirect` property to `redirect_to` in the `account` REST API route to match the core WordPress naming convention.
* TWEAK: Remove use of `Request\Redirect` in the `Account REST API` and utilize the request `redirect_to` property.
* TWEAK: If the URL passed into `From/setRedirect()` fails validation set the `redirect` property to an empty string.
* TWEAK: Refactor the default `redirect_to` value to match WordPress core in the REST API `Account\Login` endpoint.
* TWEAK: Change the priority of the `parse_request` from `10` to `11` to stop Event Espresso from breaking the ability to parse the request variables.
* BUG: Correct the default address name return value.
* DEV: Update `dist` files.
= 10.4.49 08/25/2023 =
* NEW: Introduce the `Email` field to the Fields API.
* NEW: Introduce `Request\Redirect`.
* NEW: Introduce the `account\register` REST API endpoint.
* NEW: Introduce the Register User form.
* TWEAK: Rename the callback for the `account/login` endpoint to `userLogin` for consistency in naming.
* TWEAK: Move the confirmation message for the Request Reset Password form to the JSON response of the `account/request-reset-password` endpoint.
* TWEAK: Refactoring of the client-side JS form processing to allow confirmation messages to be passed via the REST API response.
* TWEAK: Refactor the core form submit event listener use of apiFetch, disabling the default parsing of API responses and use a private parse callback instead to ensure consistent request responses.
* BUG: Initialize the correct form in the `account/login` REST endpoint for validation.
* OTHER: Correct misspelling.
* DEV: phpDoc corrections.
* DEV: Inline comments must end in full-stops, exclamation marks, or question marks.
* DEV: Parameter comment must end with a full stop.
* DEV: Remove unnecessary inline var phpDoc comment.
* DEV: Remove unnecessary import.
* DEV: Update the `dist` files.
= 10.4.48 08/10/2023 =
* NEW: Bump tested to WordPress version 6.3.
* NEW: Introduce the `account/reset-password` REST API endpoint.
* TWEAK: Refactor the toggle weak password confirm to use a boolean vs using the weak password score when determining whether to display or not.
* TWEAK: Add the default value and the field validation schema to the weak password confirmation.
* TWEAK: Remove the `login` hidden field from the reset password form.
* TWEAK: Set password reset key cookie after rendering the reset password form.
* OTHER: Add punctuation to sentences.
= 10.4.47 08/04/2023 =
* NEW: Add support for the "Remember Me" checkbox in the login form.
* NEW: Introduce the `account/request-reset-password` REST API endpoint.
* NEW: Introduce the Account Request Reset Password form.
* NEW: Introduce `Form::getHeader()` and `Form::getFooter()` so the sections of the form be overridden.
* NEW: Introduce the Reset Password form.
* TWEAK: Add support for `implicit/after` and `implicit/before` when defining field label positioning.
* TWEAK: Minor CSS tweaks, adding gaps between fields and a space between a checkbox field and its label.
* TWEAK: Set form description in the constructor.
* TWEAK: Removed unused class property.
* TWEAK: Add default styling for form confirmation and error messages.
* TWEAK: Refactor the Form API JavaScript to support multiple forms on a page when attaching event listeners.
* TWEAK: Remove unused `message` property from the base `Form` object.
* TWEAK: Set the default value of the `header` and `footer` properties to be an empty string in the `Form` object.
* TWEAK: Refactor `Form::getShortname()` to not use a static variable as each new form instance must return the current instance class shortname.
* TWEAK: Add output buffering to the `Form` object actions.
* TWEAK: Add action before and after rendering a form field in the `Form` object.
* TWEAK: Add a space between a checkbox field and its label.
* TWEAK: Add current user can check before registering an admin message.
* TWEAK: Change filter name from `Connections_Directory/Form/{Form_Name}/Render/Field/Before` to `Connections_Directory/Form/{Form_Name}/Field`.
* OTHER: Correct misspellings.
* DEV: Remove @todo.
* DEV: phpDoc corrections.
* DEV: Update .eslintrc.
* DEV: Update the `dist` files.
== Upgrade Notice ==
= 10.4.47 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.48 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.49 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.50 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.51 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.52 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.53 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.54 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.55 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.56 =
It is recommended to back up before updating. Requires WordPress >= 5.8 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.57 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.58 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.59 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.60 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.61 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.62 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.63 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.64 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.65 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.
= 10.4.66 =
It is recommended to back up before updating. Requires WordPress >= 6.0 and PHP >= 7.0 PHP version >= 7.4 is recommended.