=== Eilmo - Business Directory & Classified Listings ===
Contributors: genzplugin, jhfahim
Donate link: https://github.com/itfahim
Tags: business directory, directory listings, classified ads, local business, listing plugin
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build business directories, classified ads websites, and local listing platforms with Eilmo Directory.

== Description ==

Eilmo - Business Directory & Classified Listings is a modern WordPress plugin designed for building scalable directory websites, local business portals, service marketplaces, and classified ads platforms.

The plugin includes frontend listing submission, dynamic custom fields, user dashboards, profile management, listing reviews, interactive maps, listing packages, AJAX-powered interfaces, and much more.

Eilmo Directory is lightweight, developer-friendly, responsive, and built following modern WordPress coding standards.

== Key Features ==

* Frontend listing submission system
* Edit and manage listings from user dashboard
* AJAX-powered add/edit/delete listings
* Business directory & classified ads support
* Dynamic custom listing fields builder
* 20+ custom input fields
* Category-based custom fields
* Leaflet map integration
* User profile dashboard
* Listing reviews & ratings system
* Social profile links
* Image gallery upload support
* Listing packages & pricing system
* Bank transfer checkout system
* Listing search & filters
* Load more AJAX pagination
* Responsive modern UI
* Secure nonce verification
* Extensible AJAX and hook architecture
* Developer-friendly code structure
* Template system for developing custom themes

== Core Features List ==

* Frontend Listing Submission
* Edit Listings from Dashboard
* Delete Listings with AJAX
* Listing Approval Workflow
* Dynamic Custom Fields Builder
* Category-Based Field Conditions
* Listing Reviews & Ratings
* User Profile Management
* Social Links Repeater
* Interactive Leaflet Maps
* Address Geolocation Search
* AJAX Search & Filters
* Listing Packages
* Checkout & Order System
* User Dashboard
* Listing Gallery Upload
* Secure Form Validation
* Responsive Layout
* Translation Ready
* WordPress Coding Standards

== Perfect For ==

* Business Directory Websites
* Classified Ads Platforms
* Local Business Listings
* Real Estate Portals
* Restaurant Directories
* Service Provider Listings
* Job & Freelancer Listings
* Automotive Listings
* Travel & Tourism Directories
* Community Listing Platforms
* City Guides
* Startup Directories
* Any custom directory website

== Third Party Libraries ==

This plugin uses or includes the following third-party libraries/assets:

= jQuery =

jQuery is provided by WordPress and is used by the plugin for interactive functionality.

License: MIT License
Source:
https://jquery.org/

= Leaflet.js =

Leaflet.js is included locally with the plugin and is used to display interactive maps.

License: BSD-2-Clause License
Source:
https://leafletjs.com/

= Swiper.js =

Swiper.js is included locally with the plugin and is used for slider and carousel functionality.

License: MIT License
Source:
https://swiperjs.com/

= Flaticon Icons =

Some icons used by the plugin originate from Flaticon.

License:
https://www.flaticon.com/legal

Source:
https://www.flaticon.com/

== External Services ==

Eilmo Directory uses the external services described below for map, geocoding, and avatar functionality.

= OpenStreetMap Tile Service =

Eilmo Directory uses map tiles provided by the OpenStreetMap Foundation to display interactive maps.

When a page containing an enabled Eilmo Directory map is displayed, the visitor's browser requests the map tiles needed for the currently visible map area from the OpenStreetMap tile servers.

These requests include the requested map tile coordinates and standard technical request information that may include the visitor's IP address, browser information, referrer information, and other HTTP request data normally transmitted when requesting web resources.

No Eilmo Directory account credentials or listing form data are intentionally sent to the OpenStreetMap tile service as part of these tile requests.

This service is provided by the OpenStreetMap Foundation (OSMF).

OpenStreetMap Tile Usage Policy:
https://operations.osmfoundation.org/policies/tiles/

OpenStreetMap Foundation Terms of Use:
https://osmfoundation.org/wiki/Terms_of_Use

OpenStreetMap Foundation Privacy Policy:
https://osmfoundation.org/wiki/Privacy_Policy

= OpenStreetMap Nominatim =

Eilmo Directory uses the OpenStreetMap Nominatim service for address search and reverse geocoding in its map and location features.

When a user searches for an address using an Eilmo Directory location field, the entered address text is sent to the Nominatim service so that matching geographic coordinates can be returned.

When Eilmo Directory needs to convert geographic coordinates into a human-readable location, the relevant latitude and longitude coordinates are sent to the Nominatim service.

Nominatim requests are made only when map or location functionality requiring address search or reverse geocoding is used.

Standard technical request information, such as the user's IP address, browser information, and other HTTP request information, may also be processed by the service provider when these requests are made.

No Eilmo Directory password or payment information is intentionally sent to Nominatim.

This service is provided by the OpenStreetMap Foundation (OSMF).

Nominatim Usage Policy:
https://operations.osmfoundation.org/policies/nominatim/

OpenStreetMap Foundation Terms of Use:
https://osmfoundation.org/wiki/Terms_of_Use

OpenStreetMap Foundation Privacy Policy:
https://osmfoundation.org/wiki/Privacy_Policy

= Gravatar =

Eilmo Directory may use Gravatar to display a user's profile image when a locally configured profile image is not available.

When an Eilmo Directory page displays a user avatar using WordPress avatar functionality, WordPress may generate a Gravatar image URL using a cryptographic hash derived from the user's email address.

The visitor's browser may then connect to Gravatar to retrieve the avatar image. Standard technical request information, including the visitor's IP address, browser information, and other HTTP request information, may be transmitted as part of the image request.

Eilmo Directory does not intentionally send the user's plain-text email address to Gravatar through this avatar request.

Gravatar is a service provided by Automattic Inc.

Gravatar / Automattic Terms of Service:
https://wordpress.com/tos/

Automattic Privacy Policy:
https://automattic.com/privacy/

Gravatar Privacy and Security Information:
https://support.gravatar.com/privacy-and-security/

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory or install through the WordPress Plugins screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Configure plugin settings from the Eilmo Directory admin panel.
4. Create pages and add plugin shortcodes.
5. Start creating listings.

== Frequently Asked Questions ==

= What is Eilmo Directory? =

Eilmo Directory is a WordPress business directory and classified listings plugin that allows you to create modern directory and listing websites.

= Does Eilmo Directory support frontend listing submission? =

Yes. Users can submit, edit, and manage listings directly from the frontend dashboard.

= Does the plugin support maps? =

Yes. Eilmo Directory includes Leaflet and OpenStreetMap integration with draggable markers and address search.

= Can users leave reviews? =

Yes. Listings support ratings and review submissions.

= Does Eilmo Directory support custom fields? =

Yes. You can create dynamic custom fields and assign them by category.

= Is the plugin developer friendly? =

Yes. Eilmo Directory follows WordPress coding standards and uses an organized OOP architecture.

== Screenshots ==

1. Build flexible listing forms using the intuitive drag-and-drop form builder.
2. Configure custom field options, required fields, and category-specific assignments.
3. Submit complete business details, pricing, amenities, and professional listing media from the frontend.
4. Add contact information, business hours, and an accurate OpenStreetMap location before publishing.
5. Browse business and classified listings with responsive filters, categories, pricing, and grid views.
6. Manage published, pending, and expired listings from the frontend user dashboard.

== Changelog ==

= 1.0.0 =

* Initial release.
* Frontend listing submission system.
* User dashboard and profile management.
* Dynamic custom fields builder.
* Reviews and ratings system.
* Listing packages and checkout.
* AJAX listing management.
* Leaflet map integration.

== Upgrade Notice ==

= 1.0.0 =
Initial public release of Eilmo Directory business directory and classified listings plugin.
