TurnKey Directories

Yes. The core directory (manual listing creation, public pages, schema, sitemap) works without any external integrations. Mapillary and Google are opt-in.

Architecturally targeted at large directories on standard shared hosting. Performance scales with your DB, hosting tier, and whether you have an external object cache (Redis or Memcached) configured. The dynamic-routing layer caches city/state/country queries through wp_cache_* (with a transient fallback) so high-traffic pages do not hammer MySQL. The free plugin supports an unlimited number of manually created listings; to populate a directory in bulk, the Pro add-on adds CSV/XLSX import and business-data import via the Outscraper API.

Yes. All third-party credentials (Mapillary, Google OAuth refresh/access tokens) are encrypted at rest using sodium_crypto_secretbox (XSalsa20-Poly1305) with a key derived from wp_salt('auth'). Existing plaintext options are migrated transparently on first read.

The directory stores the business listings you create. For abuse prevention, the built-in security log records the IP address, user agent and request path of requests that trip a rate limit or look malicious, keeping only a rolling window of the most recent entries so repeat offenders can be blocked. No cookies are set on visitors, and the plugin adds no analytics or tracking tag to your public pages. You can clear the security log at any time from Dashboard → Health → Security Logs.

Submit https://your-site.com/turnkeydir-sitemap.xml. It is a sitemap index that lists your listing pages and your niche, country, state and city pages, split into files of up to 10,000 addresses. It is built when requested, so it is always current. If no SEO plugin serves /sitemap.xml, that address shows the same index. With Yoast SEO or Rank Math, the directory sitemap is also listed inside their sitemap, so submitting theirs is enough.

Yes. On directory and listing pages the plugin passes its title, meta description, canonical URL and social tags to Yoast SEO, Rank Math, All in One SEO or SEOPress, so each page has exactly one set of tags. Without an SEO plugin, the plugin prints them itself.

Yes. The maps use OpenStreetMap's public tile server, which is meant for light use. Busy sites should use a commercial tile provider; add this to a small plugin or your theme's functions.php and fill in your provider's details: add_filter( 'turnkeydir_map_tiles', function ( $tiles ) { $tiles['url'] = 'https://tiles.example.com/{z}/{x}/{y}.png?key=YOUR_KEY'; $tiles['attribution'] = '&copy; Example Maps &copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'; return $tiles; } );

Yes. Every action and filter is listed with its arguments in includes/class-turnkeydir-hooks.php. New in 3.1.4: Listing images: turnkeydir_listing_image( $row, $context ) (or TURNKEYDIR_Listing_Image::resolve()) returns the image a listing shows — owner image, else street view, else imported photo, else none — and the turnkeydir_listing_image filter changes it. TURNKEYDIR_Listing_Image::tier_for_row() gives a listing's image group (0 own image, 1 street view, 2 imported photo, 3 none). Changing images: TURNKEYDIR_Listing_Image::set_custom_image( $id, $url, $by ) and clear_custom_image( $id, $by ) set or remove a listing's own image. Code that writes custom_featured_image, mapillary_image_url or photo itself must call TURNKEYDIR_Listing_Image::touch( $ids ) afterwards; importers fire the turnkeydir_listings_imported action with the new listing IDs instead. The turnkeydir_image_tiers_ready action fires when the one-time image update has finished. Image hosts: the turnkeydir_blocked_image_hosts filter lists hosts whose images are never shown (default google.com, googleapis.com). Order of listings: TURNKEYDIR_Listing_Image::order_by( $sort, $geo, $alias ) builds the order used on every list; the turnkeydir_listing_order_by filter changes it (keep a unique last key so paging stays correct). Street view: TURNKEYDIR_Mapillary_API::refresh_listing( $id ) looks up one listing now; TURNKEYDIR_Mapillary_API::start_fast_pass() starts the background search. Filters turnkeydir_mapillary_fast_concurrency, turnkeydir_mapillary_fast_rpm, turnkeydir_mapillary_fast_purge_interval and turnkeydir_mapillary_api_base tune it. Edit Listing: the turnkeydir_edit_listing_sections action adds admin-only panels below the listing fields (they are posted with Save, so don't reuse listing field names). Setup wizard: the turnkeydir_wizard_leave action and the turnkeydir_wizard_activities, turnkeydir_wizard_sections, turnkeydir_wizard_substeps and turnkeydir_wizard_exit_url filters let add-ons add their own sections, steps and running work. TURNKEYDIR_Installation_Wizard::instance() offers get_step_url(), get_step_number(), get_resume_slug(), next_url(), prev_url(), leave_url() and reset_progress(); in the browser, TURNKEYDIRWizard.setBusy() / clearBusy(). Admin helpers: turnkeydir_admin_current_tab() (the dashboard tab being shown), turnkeydir_asset_version( $file ) (a version that changes whenever the file changes) and turnkeydir_admin_send_nocache(). Add-ons should check that a function or class exists before calling it, so they keep working with older versions of the plugin.

Visit Settings → Danger Zone → Delete all plugin data on uninstall and check the box BEFORE deleting the plugin from the Plugins page. The default behavior preserves your data so you can reinstall without loss.