=== Directory 4 Me ===
Contributors: yewaung
Tags: directory, listings, business directory, reviews, booking
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A light listing directory for any kind of listing (places, people, businesses, doctors and hospitals), with filters, reviews, maps and appointments.

== Description ==

Directory 4 Me turns a site into a listing directory for any subject. Nothing
is built in: every listing type and field can be renamed or removed in
Directory > Settings. To start quickly, add a ready-made set on the Types tab:
the plugin brings "Places and people" (a person can work at a place); themes
can bring their own with the d4m_starter_sets filter (Theme4me Doctor brings
"Doctors and hospitals", which the demo content uses). Works with any theme,
classic or block, with or without Elementor.

* Listing types, categories (specialities) and locations; custom fields per type.
* Archive with keyword search, filters, sorting, grid or list view.
* Reviews with star ratings, appointment requests (honeypot, signed time stamp,
  hourly and daily caps; no nonce so pages stay cacheable), saved listings.
* Shortcodes with a generator: [d4m_listings], [d4m_search], [d4m_categories],
  [d4m_locations], [d4m_appointment], [d4m_saved], [d4m_count]. Elementor widgets.
* Design listing pages and the listings list with the free Elementor: make a
  template with "Listing part" widgets (profile header, about, reviews, booking
  form, map ...) and choose it in Directory > Settings > General. Without a
  template the built-in design is used.
* Works with ACF (fields shown on the listing page), CPT UI taxonomies, Map 4 Me
  (listings on a map), Event 4 Me (events at a listing) and Spam 4 Me.
* One-click demo content (Directory > Settings > Demo) and WP-CLI: wp d4m demo.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ and activate it.
2. Go to Directory > Settings to choose types, fields, colours and the archive address.
3. Optional: import the demo content from the Demo tab.

== Frequently Asked Questions ==

= Does it need a special theme? =

No. Templates use the active theme's header and footer. Theme 4 Me adds matching styles.

= What does it cost to run? =

Nothing beyond hosting. Queries are cached in transients that are refreshed only
when a listing changes, and public forms have rate limits.

== External services ==

Without Map 4 Me, a listing page with a map position shows a small map loaded from OpenStreetMap (openstreetmap.org); the visitor's browser sends its IP address to OpenStreetMap. Turn it off in Directory 4 Me > General (Map). Directions and share buttons are plain links to Google Maps, WhatsApp, Facebook, X and LinkedIn; nothing is sent until the visitor clicks them.

== Screenshots ==

1. Listings with search, filters, ratings, prices and a booking button.
2. A listing page: profile, details and the booking form on the right.
3. Types: start from a ready-made set or make your own; every type can be renamed or removed.
4. Fields: add the details each listing can have, with explanations on every column.

== Changelog ==


= 1.4.0 =
* Changed: all code names now start with directory4me_ instead of the short d4m_, so they cannot clash with other plugins (WordPress.org asks for this). Your settings move to the new names on their own; listings, reviews, ratings and shortcodes are unchanged.
= 1.3.0 =
* Shared TheStickPress look in the dashboard: the same lime and ink colours, cards, switches and buttons as the other 4 Me plugins.
* Every screen starts with a short card that says what it is for and the steps to follow.
* "You have unsaved changes" bar with Save and Discard on settings pages, and a warning before leaving with unsaved changes.
* Tables of rows work the same everywhere: Remove marks a row (with Undo) and it goes when you save; "+ Add" adds a row; built-in rows show a lock that explains why.
* No built-in types any more: every type can be renamed or removed. "Kind of directory" is replaced by ready-made sets that add types and fields once (the plugin brings "Places and people"; themes can bring more with the d4m_starter_sets filter). Existing sites keep all their types, fields and wording.
* Doctors and hospitals moved out of the plugin into the Theme4me Doctor theme.
* Booking moved to Form 4 Me: each type has a Button (a Form 4 Me form or none, with its text), and each listing can have its own (a form, a link in the same or a new tab, or none). The built-in appointment form, the Appointments list and the request settings are removed; old requests are moved into Form 4 Me entries. [d4m_appointment] now shows the type's form.
* Types: new "Is a" (person or place) and "Book button" columns. A removed type with no listings is deleted completely, together with set fields used only by it. Types with listings but no settings are listed under "Types not in use".
* Fields: one empty row instead of two, and tooltips on every column.

= 1.2.0 =
* Presets (Directory > Settings > Types > Kind of directory): General (places and people) or Healthcare (doctors and hospitals). Existing sites with doctors keep Healthcare.
* No doctor or hospital code left in the core: facts, "open 24 hours", linked listings ("People at ..."), map position fallback, wording and layout come from the type settings and fields.
* Wording per preset (reviews heading, search hints, archive titles, form labels) and new icons: building, store, home, cup.
* Search type tabs wrap on small screens.
* Works in any theme: sizes include padding even when the theme does not set box-sizing (found on Twenty Twenty-Five).
* New 4ME icon (TheStickPress family) in assets/brand (SVG, 128 and 256 px) and on the TheStickPress overview.

= 1.1.0 =
* Shared "TheStickPress" admin menu: the settings are now under TheStickPress (old addresses redirect).
* Design listing pages and the listings list with the free Elementor ("Listing part" widgets).
* Parts in Elementor templates: empty parts print nothing; image ratio and spacing match the built-in page.
* One spacing value between boxes (follows the theme's "Space between boxes" when the theme sets it).
* Small labels are at least 12 px.
* Coding standards: class file names follow WordPress rules.

= 1.0.0 =
* First release.

== Upgrade Notice ==


= 1.4.0 =
Code names now use the full directory4me_ prefix. Settings move automatically; shortcodes keep working.
= 1.3.0 =
Part of the 4 Me family by TheStickPress. See the changelog for what is new.
