ThemeREX Auto Dealer
| 开发者 | themerex |
|---|---|
| 更新时间 | 2026年8月19日 04:13 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
ThemeREX Auto Dealer is a complete vehicle inventory plugin built for dealerships, classifieds sites, and automotive marketplaces.
It registers a
trx_ad_listing custom post type that handles cars, trucks, motorcycles, boats, RVs, ATVs, and commercial vehicles in a single inventory. Every standard vehicle attribute — make, model, year, mileage, condition, fuel type, transmission, drivetrain, body style, color, price, and 30+ more — has first-class admin UI, taxonomies, REST endpoints, and Gutenberg/Elementor surfacing.
Free features
- Vehicle CPT with 10 specialised taxonomies (make, model, body style, fuel type, transmission, drivetrain, condition, color, vehicle type, features)
- Dealer CPT with logo, location, contact, and hours
- 16 Gutenberg blocks (Search Form, Vehicle Grid, Vehicle Card, Specs Table, Contact Form, Dealer Info, Single Listing, Media Slider, Specs Highlights, Similar Vehicles, Recently Viewed, Featured Carousel, Favorites List, Compare Link, Comparison Table, Map View)
- 17 Elementor widgets covering all the above + theme-builder conditions for "All Vehicles" / "All Dealers" (full list in the Elementor Widgets section below)
- 10 dynamic tags for Elementor — bind any text widget to VIN/Make/Model/Year/Mileage/Price/Fuel/Status/Gallery/Dealer
- 4 starter block patterns — inventory page, single vehicle, dealer landing, search hero
- AJAX-powered archive filters (price range, year range, mileage range, body style, fuel type, condition, dealer, status, featured, accident-free)
- Server-side aggregation cache with event-driven invalidation
- Custom DB table
wp_trx_ad_vehicle_specsfor sub-200ms search response on up to 5,000 listings - REST API endpoints:
/vehicles,/vehicles/{id},/dealers,/dealers/{id},/models?make=N,/search-options,/forms/submit,/leads,/vehicles/{id}/pdf - PDF spec sheet generation via Dompdf (free)
- QR code on listing edit screen via chillerlan/php-qrcode (free)
- Compare bar + favorites (localStorage, no login required)
- Recently viewed strip
- Similar vehicles widget (3-tier heuristic: body+condition → make → body alone)
- EV-specific fields (battery capacity, range, charge time)
- schema.org structured data — Car, Vehicle, Motorcycle, Offer, AutoDealer, BreadcrumbList, FAQPage
- SEO-plugin compatibility — Yoast, Rank Math, AIOSEO, SEOPress, The SEO Framework, AEO Optimizer, or standalone
- Lead capture forms — inquiry, test-drive, callback, finance, trade-in
- Auto-reply email to customer + dealer notification with merge tags
- Per-IP rate limit (3/hour/listing) to deter spam
/llms.txtAI-crawler discovery file (standalone mode)- WPML + Polylang i18n support
- Bulk admin actions (mark available, sold, reserved, coming soon, feature, unfeature)
- Quick-edit featured toggle
- Vehicle specifications panel covering 29 non-taxonomy spec fields
trx_ad_dealer+trx_ad_agentuser roles with curated capabilities- Data isolation — dealers see only their own listings + leads
- Per-listing analytics (views, calls, WhatsApp taps, inquiries) with cookie-debounced view tracking
- Dealer performance dashboard + dealer directory shortcode
- Social proof counters (X people viewed today)
- Dealer response-time badge
trx_ad_leadCPT auto-captures every inquiry, call, WhatsApp tap, and test-drive request- 5-state status workflow (new → contacted → qualified → closed_won/lost) with auto-logged transitions
- Internal notes with timestamps
- Per-dealer email notification routing (Reply-To customer)
- HMAC-SHA256 signed outbound webhooks
- CSV export with active list filters respected
- WooCommerce integration — reservation deposits + per-listing fees + paid featured listings (7/14/30-day tiers)
- Geo radius search + saved searches + daily email digest + Web Push notifications (VAPID-signed)
- Test-drive booking with calendar UI + per-dealer hours
- Price tracking + "Reduced by $X" badge + single-page sparkline
- CSV import + export with 3-mode duplicate handling (skip / update / replace)
- XML import + export
- Scheduled imports (WP-Cron)
- VIN decoder (NHTSA + bring-your-own paid API)
- AI listing description generator (bring-your-own OpenAI key)
- 4 marketplace feed adapters (Facebook Marketplace, AutoTrader, AutoScout24, Mobile.de) with per-dealer feed keys
- AEO/GEO optimization — agent-discoverable schema, AI-bot policy, sitemap variants
- Per-listing layout overrides (Gutenberg / Elementor / default)
- Custom field schema editor + frontend renderer + CSV bridge
- Multisite network-wide settings
do_action( 'trx_ad_register_modules' ), so deactivating Pro safely reverts to free behavior with no data loss.
Why a custom DB table?
Performance. WordPress's postmeta table indexes by post_id + meta_key but not by meta_value, so a filter like "Toyota Camry, 2018-2022, under $25k, under 60k miles" forces ten cross-joins against postmeta — fast at 50 listings, painfully slow at 5,000.
This plugin maintains a denormalised wp_trx_ad_vehicle_specs table with one row per listing and ~55 indexed columns. The taxonomies remain the source of truth (you can change a make's slug and it updates everywhere); the specs row is rebuilt automatically by a save_post_trx_ad_listing hook. Search queries hit the specs table directly via a single SQL statement.
The table is rebuilt idempotently on plugin upgrade and on demand via a re-sync helper.
Privacy
The free plugin does NOT phone home. No telemetry, no opt-in dialogs, no remote analytics.
The lead capture form sends submissions via wp_mail() to the configured admin email — same channel WordPress uses for password resets. Outbound HTTP requests from the free plugin: none by default. If you enable a map provider, map tiles and geocoding requests occur as documented in the "External services" section below; with the default "Disabled" setting no request ever leaves your site.
The Pro plugin adds VIN decoder (sends VIN to NHTSA over HTTPS, opt-in per request), AI description generator (sends a prompt to OpenAI's API using YOUR API key, opt-in per request), and outbound webhook (sends lead data to a customer-configured URL, opt-in per webhook). All are off by default.
安装:
- Upload the plugin zip via
Plugins → Add New → Upload Plugin, or extract intowp-content/plugins/. - Activate ThemeREX Auto Dealer through the Plugins screen.
- Visit
Listings → Settingsto configure currency, units, and per-page count. - Add a dealer at
Listings → Dealers → Add New. - Add vehicles at
Listings → Add New. Fill in the Vehicle Data meta box on the right side of the edit screen. - Build your inventory archive — drop the Search Form and Vehicle Grid blocks onto a page (Gutenberg) or use the equivalent Elementor widgets.
屏幕截图:
常见问题:
Does this work with my theme?
Yes. The plugin ships its own templates for archive and single-listing screens, and falls back to your theme's single.php / archive.php if you've overridden it. Use Listings → Settings → Layouts to pick between the plugin's default, Gutenberg, or Elementor as your single-listing layout. Custom theme templates can be dropped into your-theme/trx-auto-dealer/ and the plugin's template loader will pick them up (WooCommerce-style override system).
Can I import my existing inventory?
The Pro plugin includes CSV and XML importers with 3-mode duplicate handling (skip / update / replace). The free plugin can import via WP All Import or any third-party tool by writing to the trx_ad_listing post type and the relevant taxonomies — the specs table syncs automatically.
Does it support electric vehicles?
Yes. Battery capacity (kWh), electric range (mi/km), and charge time are first-class fields with their own admin UI section. The EV cost estimator computes annual electricity cost and cost/km based on your local rates.
Does it work with WooCommerce?
The free plugin runs fine alongside WooCommerce but doesn't integrate with it — vehicles are NOT WC products. The Pro plugin adds optional WC integration for taking refundable deposits and charging per-listing fees in marketplace mode.
Multilingual support?
Full WPML and Polylang support at equal depth. The wpml-config.xml shipped with the plugin tells WPML which fields are translatable; Polylang's auto-detection covers the same cases via the same hooks.
GDPR / privacy compliance?
The free plugin doesn't collect or transmit any user data. Lead form submissions go to your own email via wp_mail(). No cookies are set by the plugin except for the recently-viewed-vehicles strip (sessionStorage, expires when the user closes the tab — no server-side persistence) and the optional geo-radius prompt in Pro (15-minute expiry, opt-in).
Where do search filters get their data from?
The plugin maintains a wp_trx_ad_vehicle_specs custom table — one row per listing, ~55 columns indexing every searchable attribute. Filters run a single SQL query against this table instead of cross-joining postmeta. This makes "Toyota Camry, 2018-2022, under $25k, under 60k miles" fast at 5,000 listings; standard WP_Query would crawl at that scale.
I changed my theme and search results look wrong.
Your theme may be intercepting the trx_ad_listing archive. Try Listings → Settings → Templates and toggle between the plugin's default and your theme's template. If you've added template overrides in your-theme/trx-auto-dealer/, those take precedence — remove or fix them.
Do I need any other plugins?
No required dependencies. Optional integrations: Elementor (for the widget set), Yoast SEO / Rank Math / AIOSEO / SEOPress / TSF / AEO Optimizer (for schema-piece coordination — the plugin works fine standalone), WooCommerce (Pro-only, for deposits/fees), WPML or Polylang (for multilingual).
Where is support?
- Community support: WordPress.org plugin forum.
- Premium support (priority response): included with the separate Pro plugin from themerex.net.
更新日志:
1.0.13 — 2026-08-18
- Added: bundled translations for 8 locales — Spanish (es_ES), Italian (it_IT), German (de_DE), French (fr_FR), Russian (ru_RU), Ukrainian (uk), Portuguese (pt_PT), and Brazilian Portuguese (pt_BR). Covers the full catalog: admin, frontend, widgets, and the block editor.
- Fixed: block-editor strings now load translations — the editor script's JED catalogs are registered via
wp_set_script_translations(), and the translation template now includes the editor's JavaScript strings.
- Removed: the bundled Select2 library. Select2 has published no stable release after 4.0.13 (its only newer release is the 4.1.0-rc.0 release candidate), so rather than ship an outdated or pre-release library the plugin no longer bundles it at all. The admin taxonomy pickers on the vehicle edit screen now use native WordPress multi-select fields, and the Make → Model cascade runs on plain JavaScript.
- Changed: bundled Select2 library downgraded from the 4.1.0-rc.0 release candidate to the latest stable release, 4.0.13.
- Changed: every shortcode callback and the single-listing content filter now apply
wp_kses()against the plugin's HTML allowlist at thereturnstatement, so the escaping of returned markup is explicit at the callback boundary.
- Changed: the dashboard listing-delete link now uses a fixed nonce action, so the handler verifies the nonce before reading any other request parameter; the listing ID is validated afterwards and per-listing authorization is enforced separately via
current_user_can( 'delete_post' ). - Changed: every remaining superglobal read is sanitized in the same expression as the read (
map_deep()/array_map()overwp_unslash()); no sanitization-related PHPCS exemptions remain anywhere in the plugin. - Changed: the generated appearance CSS is additionally passed through
wp_strip_all_tags()beforewp_add_inline_style()as defense in depth (all values were already sanitized as hex colors / clamped integers at save time).
- Changed: every HTML fragment the plugin renders is now escaped at the point of output with
wp_kses()against an explicit allowlist — no escaping exemptions remain outside binary/plain-text download streams. - Changed: all admin settings-tab and quick-edit JavaScript moved into the enqueued
admin.jsbundle; PHP passes data only viawp_localize_script(), and no script bodies are composed in PHP. - Changed: the frontend print button and dashboard delete confirmation now use data attributes handled by the enqueued frontend script instead of inline
onclickhandlers. - Changed: the "Pro Version" admin page is now purely informational — it links to the separately distributed Pro plugin's page and contains no pricing, checkout, or locked-looking interface elements. The blurred leads preview screen and disabled per-listing-layout controls were removed entirely.
- Changed: meta-box section save handlers each re-verify the save nonce independently, and the frontend listing-delete handler verifies its nonce before reading any request parameter.
- Changed: uninstall no longer rewrites the core roles option manually; it uses
remove_role()and busts the object cache. - Changed: bundled license files ship with a
.txtextension, and internal build tooling is excluded from the distributed archive.
- Changed: removed the "Pro" badge from the Maps and Taxonomies settings tabs — both features are and always were fully functional in the free plugin; the label was misleading.
- Changed: dealer-address geocoding now runs only when a map provider is actively selected. With maps disabled (the default) no request ever leaves your site. The services used are documented in the new "External services" readme section.
- Changed: all admin and widget styling/scripts now load through enqueued files or wp_add_inline_script/style — no more raw script/style tags in page output.
- Changed: JSON-LD structured data is emitted with escaped slashes so listing content can never break out of the script context.
- Updated: dompdf PDF library 2.0.8 → 3.1.5 (latest, includes upstream security fixes).
- Fixed: PDF spec sheet generation failed with a "Class not found" error on every distributed build — the dependency-isolation step (PHP-Scoper) did not rewrite php-font-lib's dynamically built class names, so loading any TrueType font (all PDFs use DejaVu Sans) crashed. The build now patches the three affected call sites, and the release gate renders a real PDF through the shipped files before a zip can ship.
- Fixed: bulk actions ("Mark as Sold" etc.) and quick-edit on the vehicle list table updated only the internal search index, not the vehicle itself — so the change silently reverted on the next save and status-dependent features (like the Pro Reserve button) did not follow. Both now update the vehicle and re-index it.
- Added: the dealer card (Dealer Info block/widget and Dealer Directory widget) now links to the dealer's own page — clickable name and logo plus a "View Dealer Page" button. Previously there was no way to reach a dealer's page from these widgets. The link can be switched off per widget, and hides itself when the card is shown on that dealer's own page.
- Fixed: theme mobile navigation (hamburger menu) did not open on plugin pages with block themes — the script-module import map is now printed correctly on inventory and single-listing pages.
- Fixed: the FEATURED badge on listing cards rendered underneath the favorite/compare buttons — badges now stack next to the condition badge, clear of the buttons.
- Fixed: the compare page showed the "Compare Vehicles" heading twice.
- Fixed: the single-listing spec table printed drivetrain acronyms as "Awd" instead of "AWD".
- Fixed: the compare bar button rendered "Comparenow" without a space.
- Fixed: archive filters did nothing on sites with Plain permalinks — applying a filter never narrowed the results and left a broken URL; filters now work in both AJAX and no-JS modes regardless of permalink structure.
- Added: a "Delete all data on uninstall" toggle under Settings -> Maintenance — previously the uninstall cleanup opt-in existed but had no way to enable it.
- Fixed (accessibility): the RESERVED/PENDING status badges and the FEATURED badge did not meet WCAG AA color contrast; the amber palette was adjusted (darker amber for status badges, dark text on the featured badge).
- Packaging: rebuilt the distribution autoloader — the previous zip could fail to activate with a "class not found" fatal error.
- Fixed: Custom Fields settings tab — the "Add Field" button and the per-row remove button now work, and added fields save and persist.
- Fixed: clicking the main image on a single listing now opens an enlarged lightbox with previous/next controls plus arrow-key and Escape navigation.
- Fixed: the favorites heart now fills (instead of turning the whole button into a red disc) and shows a brief confirmation toast.
- Fixed: the mobile filter drawer now opens above sticky theme headers, has a clearly visible close button, and closes automatically after you apply a filter.
- Fixed: the Appearance "Primary color" now applies to buttons, links, form fields, and the compare bar — not just the condition badge.
- Fixed: single-listing / dealer photo-gallery navigation arrows now sit over the image (they were misplaced below it) and render correctly even when Elementor is active.
- Fixed: the Elementor "Dealer Info" and "Dealer Map" widgets now render on a published page instead of appearing blank outside the editor.
- Fixed: dealer WhatsApp numbers typed with spaces, dashes, or parentheses are now saved (previously silently discarded); the dealer page now shows a "View on map" link when only a street address (no coordinates) is set.
- Fixed: inventory archive pagination — pages beyond the first showed "No vehicles found"; all pages now display their listings.
- Fixed: saving a settings tab now shows a "Settings saved." confirmation.
- Fixed: the comparison page no longer scrolls sideways on phones (the wide table scrolls within its own box).
- Fixed (accessibility): the listings results area is now a labelled region with a screen-reader heading and a live result count; zero axe-core violations across the main pages.
- Fixed (RTL): card badges and action buttons now mirror correctly in right-to-left languages.
- Fixed (performance): gallery images now declare their dimensions to prevent layout shift.
- Fixed: block themes (e.g. Twenty Twenty-Five) no longer show the "Theme without header.php is deprecated" notice on the inventory archive, single-listing, and dealer pages.
- Fixed: the
/inventory/archive now renders listings (not the blog feed) on sites using "Plain" permalinks. - Fixed: uninstall now reliably removes the Auto Dealer custom roles even on hosts with a persistent object cache.
- Fixed: breadcrumb structured data no longer emits a PHP 8.1 "null array offset" deprecation in standalone schema mode.
- Added: deactivating the free plugin while Auto Dealer Pro is active is now blocked, with a clear prompt to deactivate Pro first.
- Fixed: inventory archive AJAX (live result count, cascading make→model dropdown, facet narrowing) returned 404 on sites using "Plain" permalinks because the REST URL was built with a second "?" separator. Pretty-permalink sites were unaffected.
- Fixed: editor fields and marketplace feeds no longer render blank for listings whose data lives only in the denormalized specs table (post meta now falls back to the specs column).
- Fixed: vehicle attribute acronyms (SUV, CPO, AWD/FWD/RWD, 4WD, EV, …) now display fully upper-cased on the compare table instead of "Suv"/"Cpo".
- Fixed: Favorites/Compare toggle buttons now expose aria-pressed state and use present-tense ("Add to / Remove from") accessible labels.
- Fixed: cleared the WP 6.7+ early-translation (_load_textdomain_just_in_time) notice from the vehicle-data meta box.
- Vehicle + Dealer custom post types with full admin UI
- 10 specialised taxonomies + 13 Gutenberg blocks + 15 Elementor widgets
- Custom DB table for sub-200ms search at 5,000-listing scale
- Schema.org structured data with 7 SEO-plugin compatibility modes
- Lead capture with auto-reply + dealer notification
- PDF spec sheet generation
- WPML + Polylang i18n
- Free + Pro split with Pro plugin available separately