-
Notifications
You must be signed in to change notification settings - Fork 9
/
README.txt
496 lines (367 loc) · 21.2 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
=== LDD Directory Lite ===
Contributors: lddwebdesign
Tags: directory, listings, listing directory, business, business directory
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7EUP56RH7E8RJ
Requires at least: 5.0 or higher
Tested up to: 6
Stable tag: 3.3
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
The LDD Directory Lite plugin is the best way to add a powerful, fully functional and free custom directory to your WordPress powered web site.
== Description ==
The LDD Directory Lite plugin is the best way to add a powerful, fully functional and free custom directory to your WordPress powered web site.
Within minutes you can install and configure LDD Directory Lite and start accepting submissions, or populating the content with your own listings. This is the best and easiest way to start any kind of directory you can think of, be it of local businesses (restaurants, coffee shops, craft stores, etc), or any other type of organization you would like to build around.
The Directory is extremely user friendly, ready to go pretty much out of the box. One of our primary focuses is ensuring that it integrates with almost any theme, anywhere, anytime, and we have utilized the power of Bootstrap to ensure that the Directory is 100% mobile ready and responsive. It won't break all that hard work you've put into making sure your site works on any medium.
= Here are just a few of the many features =
* Easy to install, easy to configure
* Add the [directory] and [directory_submit] shortcode to any page (automatically installed for you, but feel free to change them)
* Default list sorting options for Categories,Featured and Listings in dashboard.
* Sort using shortcodes, i.e. [directory cat_order_by="xxx" cat_order="asc" fl_order_by="xxx" fl_order="asc" list_order_by="xxx" list_order="asc"]
* Ability to change Taxonomy and Post type slugs.
* Added new fields for listings.
* Customize the look and feel as much, or as little as you want
* Features can easily be enabled or disabled on the dashboard
* Users can easily maintain their listings through a front end control panel
* Fully customizable email notifications, for the admin and the user
* Strong focus on internationalization, we want this to work for everyone, everywhere
* Clean, fully responsive interface
* Social media integration, build traffic for your users
* Google Maps integration
* Lightweight but still powerful
* Supported Views: grid , compact
More information at [plugins.lddwebdesign.com](http://plugins.lddwebdesign.com)
= Extensions =
* [Directory Reports & Exports.](https://plugins.lddwebdesign.com/extensions/directory-reports-exports/) The LDD Directory Lite Reports and Exports extension allows a user to create reports and to export listings in multiple formats e.g XML, CSV, HTML, PDF.
* [Directory Import.](https://plugins.lddwebdesign.com/extensions/directory-import/) The LDD Directory Lite Import extension allows a user to import listings directly to their directory via CSV files that can be edited by hand or in applications such as Microsoft Excel.
* [Directory Reviews.](https://plugins.lddwebdesign.com/extensions/directory-listing-reviews/) The LDD Directory Lite Reviews extension add a powerful user review system to your online directory with star ratings, comments and filterable/searchable review content.
* [Directory Social Login.](https://plugins.lddwebdesign.com/extensions/directory-social-login/) The LDD Directory Lite Social Login extension that allow with the ability to login with facebook, google+, linkedin logins.
* [Directory Social Share.](https://plugins.lddwebdesign.com/extensions/directory-social-share/) The LDD Directory Lite Social Share extension add the ability to share your directory listings on popular social networks like Facebook, Twitter, Google+, LinkedIn, Pinterest and via E-mail.
== Installation ==
Installation is easiest when done through your WordPress Dashboard:
1. Select **Plugins >> Add New** from your sites WordPress dashboard.
1. Type **ldd directory lite** into the search field and press enter.
1. Click **Install Now** when you see ldd directory lite appear in the search results.
1. Select **Activate Plugin** after you see *Successfully installed the plugin ldd directory lite* appear on your screen.
= Upgrading from LDD Business Directory =
This plugin is a rewrite of the [LDD Business Directory](http://wordpress.org/plugins/ldd-business-directory/). As such, you can upgrade to ldd directory lite from LDD Business Directory *without* losing any of your content.
*You do not need to deactivate or uninstall the LDD Business Directory plugin before activating ldd directory lite.*
1. Install and activate the plugin using the above instructions.
1. Once installed, if data is detected from the original plugin it will automatically notify you with a rather large message at the top of your Directory Lite dashboard screens.
1. Press the "Import Data" button, and you will be taken to the upgrade page.
1. All done!
**The plugin only imports this data, it does nothing to alter or remove it. If you decide to revert to the original plugin because of errors encountered while using this beta release, you will have all you original content waiting for you.**
== Frequently Asked Questions ==
= How to sort categories, listings and featured listings using shortcode? =
You can sort categories using *cat_order_by*, listings using *list_order_by* and featured listings using *fl_order_by* attribute with shortcode.
e.g. [directory cat_order_by="**xxx**" cat_order="asc" fl_order_by="**xxx**" fl_order="asc" list_order_by="**xxx**" list_order="asc"]
**cat_order_by="xxx" :**
* id
* slug
* title
* count
**fl_order_by="**xxx**"**
* business_name
* zip
* area
* category
* random
**list_order_by="**xxx**"**
* business_name
* zip
* area
* category
* random
= How to show listings from specific category(s) using shortcode? =
You can display category specify listings using the following shortcode.
[directory_category slug="my-category,my-other-category" view="compact" list_order_by="title" list_order="ASC" limit="8"]
**view="xxx" :**
* grid
* compact
**list_order_by="**xxx**"**
* business_name
* zip
* area
* category
* random
**list_order="**xxx**"**
* ASC
* DESC
= How can I avoid having my template customizations overwritten when the plugin is updated? =
All the template files found in `/ldd-directory-lite/templates` can be copied to a directory in your theme called *lddlite_templates*.
For example, if you need to edit `/wp-content/plugins/ldd-directory-lite/templates/category.php`, you can copy it to `/wp-content/themes/your-theme-directory/lddlite_templates/category.php`. While you can copy the entire directory verbatim, it is recommended that you only copy the files you need.
== Screenshots ==
1. Most of ldd directory lite's configuration can be ignored or set once and forgotten; focus on content, don't worry about getting caught up constantly having to change settings!
2. Whether all your content is user generated, or if it's entirely owner generated, there's an easy to use interface for adding, editing, or removing listings.
3. We have done our best to design the directory's front end interface to integrate easily and painlessly with almost any theme. While it's impossible to guarantee this happening with 100% of themes, the fully responsive minimal design will quite often seem right at home, straight out of the box.
== Upgrade Notice ==
= 3.2 =
* Upgraded bootstrap js file
= 3.0 =
* fixed issue with manage listing
* Updated chosen js library
* fixed issue with placeholder image
= 2.7.4 =
* fixed archive page pagination issue
= 2.7.3 =
* fixed issues with teplate override
= 2.7 =
* fixed single template and home page issue
* Removed google plus option
* added support for map extension
* fixed home page and single page notices
= 2.6.4 =
* fixed new tab issue for website URL
= 2.6.2 =
* fixed directory shortcode issue in gutenberg block
= 2.6.1 =
* fixed social contact issue on front end listing management
= 2.5.0 =
* fixed template issues
* Added new settings options.
= 2.0.2 =
* Fixed shortcode issues with Theme default single template
* Fixed admin menu issues for multisite.
= 2.0 =
* Updated main queries
* Added more layot options
* Fixed google map bugs
= 1.4 =
* Updated request for review notification behavior
* Corrected issue with Terms of Service notice on front end
* Updated social media links
= 1.3.0 =
* Added limit options and pagination for search page
* Added pagination option and limit for home pages categories
* Updated basic queries for category listing page
= 1.2.2 =
* Fixed tag listing issue
* Added new template for listing_tag
= 1.2.1 =
* Updated sort order function and fixed bugs
* Fixed bug with css overwriting site theme fonts and structure
* Added support for content to display on Directory pages above and/or below Directory shortcodes
= 1.2.0 =
* Updated functionality of directory tags
* Added option to display full directory listing or list of categories at directory homepage
* Corrected search function to include all fields and tags
* Append to count child categories listings
* Add GEO Location for localizing map for users (not supported on http)
* Other minor bug fixes
= 1.1.2 =
* Added option for changeing behavior of category listings count (include or exclude sub categories).
* Fixed bug with listings pagination on some themes.
* Corrected output for contact form messages.
* Corrected major bug/conflict with Child Theme Configurator plugin causing all media files to be delted upan removal of LDD Directory Lite.
* Added GEO Location support for localizing map for users.
== Changelog ==
= 2.7.1 =
* fixed notice for undefined variable $prefix
= 2.7 =
* fixed single template and home page issue
* Removed google plus option
* added support for map extension
* fixed home page and single page notices
= 2.6.4 =
* fixed new tab issue for website URL
= 2.6.2 =
* fixed directory shortcode issue in gutenberg block
= 2.6.1 =
* Fixed social contact issue on front end listing management
= 2.6.0 =
* Added new masonry grid to grid layout
* Updated listing detail page, added featured image control
= 2.5.3 =
* Fixed media upload issue for ldd listing
= 2.5.2 =
* Fixed listing formatting issue
* Fixed user login issue with multisite
= 2.5.0 =
<h2> BUG FIXES</h2>
* Removed transient word 'plug' text from single listing header
* Fixed issue with listing title displaying twice in some themes
<h2> ENHANCEMENTS</h2>
<h4> SETTINGS</h4>
* General Settings => Moved "Show Image Placeholder" to bottom of Appearance tab
* Featured Listings => (i) Added option to control where the featured listings are displayed on the Directory Homepage (top/bottom)
* Featured Listings => (ii) Added option for changing the title text of the Directory Featured Listings
* Email Settings => (i) Added shortcode selector for notification messages with directory form fields
* Email Settings => (ii) Updated labels for notification message fields so they are less confusing
* Submit Settings => (i) Added shortcode selector for terms of service, introduction, and success message editors with directory form fields
* Appearance Settings => (i) Improved controls for default view of listings on front end (compact view /grid view)
* Appearance Settings => (ii) Added controls on front end for compact/grid view
* Appearance Settings => (iii) Added controls on directory home page for showing categories or directory listings
* Appearance Settings => (iv) Show Image Placeholder option now removes all images from category view in directory
* Appearance Settings => (v) Added image upload option for default placeholder image
<h4>FRONT END VIEWS</h4>
* Added controls for directory homepage views (Category View / Listing View)
* Added controls for category views (Grid View / Compact View)
* Redesigned search field for better responsive views on mobile and tablet
= 2.0.2 =
* Fixed shortcode issues with Theme default single template
* Fixed admin menus issues for multisite.
= 2.0 =
* Major template structure changes to accommodate user theme templates
* Template Overidding
* Introduction of new user role (Directory Contributor) for easier user management
* Added ability to assign individual Listings to users with Directory Contributor user role
* Updated directory appearance settings and controls
* Minor bug fixes
= 1.4.1 =
* Added new social media options on front end submission
= 1.4 =
* Updated request for review notification behavior
* Corrected issue with Terms of Service notice on front end
* Updated social media links
= 1.3.3 =
* Fixed issues in listing sorts
* updates search filters
= 1.3.2 =
* Fixed issues on plugin activation
= 1.3.1 =
* Added Search sort option
= 1.3.0 =
* Added limit options and pagination for search page
* Added pagination option and limit for home pages categories
* Updated basic queries for category listing page
= 1.2.2 =
* Fixed tag listing issue
* Added new template for listing_tag
= 1.2.1 =
* Updated sort order function and fixed bugs
* Fixed bug with css overwriting site theme fonts and structure
* Added support for content to display on Directory pages above and/or below Directory shortcodes
= 1.2.0 =
* Updated functionality of directory tags
* Added option to display full directory listing or list of categories at directory homepage
* Corrected search function to include all fields and tags
* Append to count child categories listings
* Add GEO Location for localizing map for users (not supported on http)
* Other minor bug fixes
= 1.1.2 =
* Added option for changeing behavior of category listings count (include or exclude sub categories).
* Fixed bug with listings pagination on some themes.
* Corrected output for contact form messages.
* Corrected major bug/conflict with Child Theme Configurator plugin causing all media files to be delted upan removal of LDD Directory Lite.
* Added GEO Location support for localizing map for users.
= 1.1.0 =
* Corrected issue with subcategories not showing in the parent category view.
* Added hooks for start and end of the page wrapper in templates for third party theme compatibility.
* Added support for WordPress default themes.
* Updated plugin strings for translation.
* Restructured template structure in sub folders.
* Fixed Google Maps API - if user selects not to use Google Maps the API should not be required at all and Maps should not show on editor or front-end submission form.
* Fixed Google Maps GEO Code Error.
* Fixed issue when directory creates multiple pages upon deactivation and re-activation.
* Fixed Add-ons page to change the button from "Buy now" to "Installed" if add-on is already present.
= 1.0.2 =
* Added Skype field to front-end submission for contact info.
* Corrected issue with Address field in placeholder text.
* Updated banner for WordPress Repo.
* Fixed warning in search template.
= 1.0.1 =
* Added links to newest premium addons available
* Removed legacy shortcode and admin settigns for "Directory Information" (These can be added to the page editor in which the main shortcode for the directory is placed if the user wishes)
* Corrected issue with Fax and Skype contact fields not output to listings view.
* Corrected 404 error issue after installation and updating url slugs in settings.
* Corrected common theme conflict in directory navigation header dropdown for categories.
* Corrected conflict with CMB2 library if used by another installed plugin.
* Corrected install date issue when plugin is activated.
= 1.0.0 =
* Added rate this plugin link to header of settings page with other links.
* Added ability to auto-request a review after user has had the plugin activated for one week.
* Changed placeholder text for address/location fields.
* Added markup for telephone number to link to action (i.e. make phone call).
= 0.8.70 =
* Added support for admin to enable/disable public submissions.
* Added support for admin to select number of featured listings to display.
* Social links will open in new tab.
* Allow admin to hide/show default image placeholder.
* Added support to auto approve listings.
* Added help page for listing all available plugin options.
* Fixed plugin's template files.
* Fixed address format.
* Fixed grid view layout.
* Fixed pagination error.
* Added a new shortcode [directory_category slug='xxx'] for displaying category specific listings.
* Fixed approval email template.
* Added support for adding Google Map API for removing javascript "noapi" notification issue.
* Updated CMB to CMB2.
* Minor bug fixes
= 0.8.6 =
* Added grid and compact view support.
* Fixed Pagination issue.
* Resolved wp_query global errors.
* Added support for displaying shortcodes in listings sidebar.
* Added add-ons support.
* Fixed shortcode overlapping issue.
* Fixed search issue.
* Minor bug fixes
= 0.8.53 =
* Fixed search menu for creating responsive view.
* Minor bug fixes
* Added support for wordpress 4.4.2
= 0.8.52 =
* Fixed list importing issue while updating from older version.
* Fixed sort issue for featured listings.
* Added pagination for inner pages.
= 0.8.51 =
* Added custom pagination support.
* Fixed css related issues.
* Fixed layout template issues.
* Added support for wordpress 4.4.1
= 0.8.5-beta =
* Added new features, fixed a major issue with the submission process, and other minor updates.
* Added multiple categories section support for front-end users.
* Added an admin notice if wrong/same post types are used.
* Updated google maps for auto fetching locations based on user provided address.
* Added default sorting options in admin panel.
* Added sorting support using shortcodes.
* Added new fields for company listings.
* Fixed few bugs.
= 0.8.4-beta =
* Fixed an issue with the submission processor not verifying the correct nonce
* Added a notice to the registration form if registration is disabled
* Using EDD as a guide, rebuilt the settings API to allow for future extension development
* Fixed a bug in the Featured Listings query that was displaying listings regardless of how they were tagged
= 0.8-beta =
* Added the front end interface for users to maintain their approved listings
* Fixed a bug in the plugin localization that wasn't properly loading mo files
= 0.7.3-beta =
* Cleaned up code formatting and style considerably across the entire plugin, adding much needed inline documentation
* Removed the RainTPL class in favor of using native PHP templates (this was a rapid deployment solution that had a terminal lifespan to begin with)
* Rewrote the submission process in an attempt to simplify and improve the process
* Removed a lot of my ugly JavaScript hacks (I'm getting better!)
* Reduced dependence on internal styling; going forward the plugin should look "pretty enough" but leave most of the presentation to the end user
* Multitude of bug fixes
* Updated screenshots (don't actually forget to do this... )
* Outlined an upgrade system for seamless transitions from one version to the next
* Improved the import process for upgrading from LDD Business Directory
* Fixed two backwards compatibility errors
* Fixed a bug in the uninstall that was causing it to fail
= 0.5.4-beta =
* Major update to the upgrade functionality for people migrating from [LDD Business Directory](http://wordpress.org/plugins/ldd-business-directory/)
* Enqueued Bootstrap core as early as possible so that theme styles will cascade after
* Moved away from handling addresses internally, utilizing Google API more effectively
* Fixed outgoing emails hardcoded From: address
* Fixed an out of memory error being caused by `ldl_get_page_haz_shortcode()`, shortcode detection is now done during `save_post`
= 0.5.3-beta =
* Added opt-in anonymous usage tracking
* Trimmed a lot of excess from Bootstrap, and removed it from the global scope (it shouldn't affect the theme anymore)
* Condensed Bootflat into the main style sheet
* Fixed an issue with the search, submitting the form now takes you to physical search results
= 0.5.1-beta =
* Initial commit of the forked [LDD Business Directory](http://wordpress.org/plugins/ldd-business-directory/) plugin.
== Credits ==
This plugin is where it is thanks to the hard work and open source beliefs of a great many people. While I always try to make sure they are credited in the code itself, I would like to take the time to include them here as well. In no particular order:
**Who:** [WebDevStudios](http://webdevstudios.com/)<br>
**Where:** [Custom Metaboxes and Fields for WordPress](https://github.com/WebDevStudios/Custom-Metaboxes-and-Fields-for-WordPress)<br>
**Why:** Used to build the administrative user interface for the directory listings custom post types.
**Who:** [yoast](https://yoast.com)<br>
**Where:** [WordPress SEO](https://yoast.com/wordpress/plugins/#wpseo) Usage Tracking<br>
**Why:** Code from the WordPress SEO plugin was integrated into this plugin in order to quickly add anonymous usage tracking. The information supplied by those who opt in to this program allows us a fantastic insight as to what configurations the plugin is being used on, and how to test future releases.
**Who:** [Bootstrap](http://getbootstrap.com/)<br>
**Where:** Front end interface.<br>
**Why:** A trimmed down copy of bootstrap was used to rapidly define the front end interface for the plugin.
**Who:** [HappyJS](http://happyjs.com/)<br>
**Where:** Single listing view.<br>
**Why:** Happy.js is used on the listing page where strong validation is critical prior to a contact form being submitted.