TIGON DMS Connect

The enterprise WordPress plugin that bridges your Tigon Dealer Management System with WooCommerce — automatically syncing golf cart inventory, images, pricing, attributes, and product data in real time.

Author: Noah Jaslow & Jaslow Digital Version: 2.0.0 Requires: WordPress 6.0+ · WooCommerce 8.0+ · PHP 8.1+

What It Does

TIGON DMS Connect takes your entire golf cart inventory from the Tigon DMS and publishes it as fully-featured WooCommerce products — complete with images, pricing, specifications, categories, and SEO-ready attributes. It supports both push (DMS sends changes in real time) and pull (WordPress fetches inventory on demand) sync models.

Every product gets:

Title & slug generated from configurable schema templates
Images downloaded from S3 and attached as WooCommerce featured + gallery images
Pricing (retail, sale) synced to WooCommerce price fields
30+ product attributes (make, model, color, drivetrain, passengers, battery, etc.)
Categories auto-assigned (make, model, new/used, lifted, seating, location, etc.)
Google, Facebook & Pinterest product feed metadata
SKU from VIN, serial number, or auto-generated fallback

Key Features

Multi-Path Inventory Sync

Sync Method	Description
REST API Push	DMS pushes individual cart changes in real time via REST endpoints
Mapped Sync	Fetches all active inventory from DMS and creates/updates WooCommerce products in batches
Selective Sync	Admin picks specific carts to sync from the DMS inventory list
Lazy Sync	On-demand product creation when a cart URL is visited (`/dms/cart/{id}`)

All sync methods support batched processing to prevent timeouts on large inventories, with progress tracking in the admin UI.

Schema Templates

Control how every product field is generated using template variables pulled from DMS cart data:

Title:    {^make}® {^model} {cartColor} in {city}, {stateAbbr}
Slug:     {make}-{model}-{cartColor}-seat-{seatColor}-{city}-{state}
Image:    {^make}® {^model} {cartColor} in {city}, {stateAbbr} image

Available variables include {make}, {model}, {year}, {cartColor}, {seatColor}, {city}, {state}, {stateAbbr}, {retailPrice}, {passengers}, {driveTrain}, and many more.

Field Mapping System

A visual admin interface for mapping any DMS JSON path to any WooCommerce field:

Post meta — Map to any _postmeta key
Taxonomies — Map to product categories, tags, or custom taxonomies
Post columns — Map to post_title, post_content, post_status, etc.
Transforms — Direct copy, template interpolation, lookup tables, or custom functions

Image Handling

Images downloaded from S3 bucket and sideloaded into the WordPress media library
First image set as featured image, rest added to product gallery
Monroney window sticker PDFs attached as product meta
Configurable image name templates for SEO
Existing images cleaned up on re-sync to prevent duplicates

7-Layer Duplicate Prevention

Multiple safeguards ensure inventory syncs never create duplicate products:

PID from DMS — WordPress post ID stored in DMS and sent back on subsequent syncs
_dms_cart_id meta lookup — Finds existing products by DMS cart ID
SKU matching — wc_get_product_id_by_sku() catches products by VIN/serial
Create/update routing — Existing product ID routes to update, not create
Write-time guards — Database layer refuses to create if ID exists, or update if ID is missing
In-memory dedup key — Prevents identical new carts within a single sync batch
PID report-back — After creation, WordPress ID is written back to DMS for future syncs

See DUPLICATE-PREVENTION-AUDIT.md for the full technical breakdown.

Product Feed Integration

Every synced product is automatically tagged with metadata for:

Google Listings & Ads — Condition, brand, color, pattern, MPN, size system
Facebook Catalog — Brand, color, condition, pattern, image source
Pinterest — Condition, Google product category
WooCommerce product feeds — All standard fields populated

Multi-Location Support

Store locations fetched from DMS API with city, state, and coordinates
Products categorized by location automatically
Featured product grids managed per location (8 new, 8 used, 4 popular)
Location-specific Elementor widgets for dealership pages

Admin Pages

Page	Description
Diagnostics	Inventory health dashboard — shows sync accuracy, missing/extra products, and DMS vs. WooCommerce comparison with pie charts
Settings	DMS API connection (URL, auth token), S3 file source, GitHub update token, REST endpoint reference, and schema template configuration
Field Mapping	Visual CRUD interface for custom DMS → WooCommerce field mappings with drag-and-drop ordering
Inventory Sync	Trigger mapped or selective syncs with real-time batch progress bars and status logging

REST API Endpoints

The plugin registers the following endpoints for DMS-to-WordPress communication:

Endpoint	Method	Purpose
`/wp-json/tigon-dms-connect/v1/push`	POST	Push a single cart (create or update)
`/wp-json/tigon-dms-connect/used`	POST	Create/update a used cart
`/wp-json/tigon-dms-connect/used`	DELETE	Remove a used cart and its media
`/wp-json/tigon-dms-connect/new/update`	POST	Create/update a new cart
`/wp-json/tigon-dms-connect/new/pid`	POST	Look up product ID by URL slug
`/wp-json/tigon-dms-connect/showcase`	POST	Set featured product grid for a location

All endpoints require manage_options capability (WordPress admin authentication).

REST API Authentication

All REST endpoints require HTTP Basic Auth using a WordPress Application Password. The authenticated user must be a WordPress Administrator (manage_options capability).

Required HTTP Headers:

Header	Value
`Authorization`	`Basic <base64(username:application_password)>`
`Content-Type`	`application/json`

The Authorization value is the word Basic followed by a space and the base64-encoded string username:application_password.

Generating an Application Password:

Go to WordPress Admin → Users → (admin user) → Edit
Scroll to the Application Passwords section
Enter a name (e.g. DMS Push) and click Add New Application Password
Copy the generated password — it is only shown once

Example cURL request:

curl -X POST \
  https://tigongolfcarts.com/wp-json/tigon-dms-connect/v1/push \
  -H "Authorization: Basic dGlnb24tZG1zOmFiY2QgMTIzNCBlZmdoIDU2NzggaWprbCA5MDEy" \
  -H "Content-Type: application/json" \
  -d '{ "vin": "...", "year": "2024", "make": "ICON", "model": "i40" }'

Key notes for the DMS integration:

No custom tokens or API keys — standard WordPress Application Passwords via Basic Auth
The WordPress user must be an Administrator
Application Passwords bypass 2FA and cookie requirements — designed for external API clients
HTTPS is required (WordPress blocks Application Passwords over plain HTTP by default)

Shortcodes

[tigon_dms_carts type="all"]

Renders a grid of DMS cart cards. Options: type="all", type="new", type="used".

[tigon_dms_inventory_filtered show_filters="yes" show_pagination="yes" per_page="20"]

Renders the full inventory browser with sidebar filters for make, model, color, location, price range, and more.

Elementor Widgets

Widget	Description
DMS Carts	Configurable cart grid — display all, new, used, or popular carts with a type selector in the Elementor editor
DMS Inventory (Filtered)	Full inventory browser with optional filter sidebar, pagination, and sorting — embeddable on any Elementor page

WooCommerce Customizations

"See Details" buttons — DMS-imported products show "See Details" instead of "Add to Cart" and link to the product page
Native attribute tabs — Product specifications display in WooCommerce's built-in "Additional Information" tab
Product ordering — Custom sort-by-price with menu order priority for catalog pages
Image zoom disabled — Product gallery zoom removed for cleaner cart image display
20 products per page — Catalog set to 5 rows of 4 products

Database Tables

The plugin creates five custom tables on activation:

Table	Purpose
`{prefix}tigon_dms_config`	Key-value configuration store (DMS URL, tokens, schema templates)
`{prefix}tigon_dms_cart_lists`	Featured product grids per location (JSON arrays of cart IDs)
`{prefix}tigon_dms_field_mappings`	Custom DMS → WooCommerce field mapping rules
`{prefix}tigon_dms_carts`	Full DMS inventory staging cache (100+ columns, denormalized)

Auto-Updates

The plugin checks for updates from its private GitHub repository on every admin page load. Configure a GitHub personal access token in Settings → General to enable automatic one-click updates from the WordPress plugins screen.

Architecture

TIGON-DMS-Connect/
├── dms-bridge-plugin.php          # Main plugin file — bridge sync, shortcodes, WooCommerce hooks
├── src/
│   ├── Core.php                   # Admin init, AJAX handlers, REST route registration
│   ├── Admin/
│   │   ├── Admin_Page.php         # Admin page HTML rendering (diagnostics, settings, sync)
│   │   ├── REST_Routes.php        # REST API endpoint handlers
│   │   ├── Database_Object.php    # Product data model for mapped sync
│   │   ├── Database_Write_Controller.php  # Direct DB writes (bypasses WP for speed)
│   │   ├── Ajax_Settings_Controller.php   # Settings AJAX handlers
│   │   ├── Field_Mapping.php      # Field mapping CRUD
│   │   ├── CartModel.php          # Staging table upsert logic
│   │   ├── Attributes.php         # Location/store data, manufacturer lookup
│   │   ├── New/Cart.php           # New cart converter
│   │   └── Used/Cart.php          # Used cart converter
│   ├── Abstracts/
│   │   └── Abstract_Cart.php      # Base cart conversion — images, templates, validation
│   └── Includes/
│       ├── DMS_Connector.php      # Authenticated DMS API client
│       ├── Somatic.php            # Image sideload utility
│       ├── WP_GitHub_Updater.php  # GitHub auto-update checker
│       └── Product_Archive_Extension.php  # Custom product ordering
├── includes/
│   ├── class-dms-api.php          # DMS API calls, S3 URLs, transient caching
│   ├── class-dms-sync.php         # Legacy paginated inventory sync
│   ├── class-dms-display.php      # Frontend cart rendering
│   ├── class-dms-elementor-widget.php     # Elementor "DMS Carts" widget
│   └── class-dms-inventory-widget.php     # Elementor "DMS Inventory" widget
├── assets/
│   ├── css/                       # Admin + frontend stylesheets
│   └── js/                        # Settings, diagnostics, API service scripts
└── templates/                     # Cart display templates

Requirements

WordPress 6.0 or higher
WooCommerce 8.0 or higher
PHP 8.1 or higher
Tigon DMS API access (URL + authentication token)
S3 bucket configured for cart images and window stickers

CDN & Caching Configuration

CDN Exclusions

Files that should not be served via CDN (one per line):

/wp-json/tigon-dms-connect/(.*)
/wp-admin/admin-ajax.php
/dms/cart/(.*)
/wp-cron.php

Never Cache URLs

Dynamic pages that should never be cached:

/dms/cart/(.*)
/wp-json/tigon-dms-connect/(.*)
/wp-admin/admin-ajax.php
/wp-cron.php
/inventory/(.*)

Always Purge URLs

Purged from cache whenever any post or page is updated:

/inventory/(.*)
/golf-cart-inventory/(.*)
/hatfield-pa/(.*)
/ocean-view-nj/(.*)
/long-pond-pa/(.*)
/dover-de/(.*)
/scranton-pa/(.*)
/raleigh-nc/(.*)
/south-bend-in/(.*)
/gloucester-va/(.*)
/bayville-nj/(.*)
/waretown-nj/(.*)
/orangeburg-sc/(.*)
/swanton-oh/(.*)
/lecanto-fl/(.*)
/golf-cart-services/(.*)
/manufacturers/(.*)
/brands/(.*)
/product/(.*)
/product-category/(.*)
/shop/(.*)

Cache Query Strings

WooCommerce filter/sort parameters safe to cache:

pa_location
pa_model
pa_battery-type
pa_drivetrain
pa_brush-guard
pa_cargo-rack
pa_electric-bed-lift
pa_electric-range
pa_extended-top
pa_fender-flares
pa_led-accents
pa_lift-kit
pa_mileage
pa_seats
pa_speed
pa_street-legal
pa_fuel-type
pa_gifted
min_price
max_price
orderby
product_cat
product_tag
product_brand
manufacturers
models

Never Cache Cookies

wordpress_logged_in_
wordpress_sec_
wp-settings-
wp-postpass_
woocommerce_cart_hash
woocommerce_items_in_cart
wp_woocommerce_session_
woocommerce_recently_viewed
comment_author_
tk_ai

Never Cache User Agents

(.*)wp-cron(.*)
(.*)WordPress(.*)
(.*)DMS(.*)
(.*)Jetstress(.*)
(.*)check_http(.*)
(.*)nagios(.*)
(.*)Pingdom(.*)
(.*)UptimeRobot(.*)
(.*)StatusCake(.*)
(.*)GTmetrix(.*)
(.*)Google-Site-Verification(.*)

CSS Files

Minify CSS removes whitespace and comments to reduce the file size.

Optimize CSS delivery eliminates render-blocking CSS on your website. Only one method can be selected. Remove Unused CSS is recommended for optimal performance.

Careful: Can break Elementor styling. Use "Load CSS Asynchronously" instead.

Excluded CSS Files

Specify URLs of CSS files to be excluded from minification (one per line).

Internal: The domain part of the URL will be stripped automatically. Use (.*).css wildcards to exclude all CSS files located at a specific path. 3rd Party: Use either the full URL path or only the domain name, to exclude external CSS.

dms-bridge(.*).css
dms-bridge-temp-single(.*).css
dms-inventory-filtered(.*).css
/wp-content/plugins/tigon-dms-connect/assets/css/(.*).css

JavaScript Files

Minify JavaScript removes whitespace and comments to reduce the file size.

Combine JavaScript files combines your site's internal, 3rd party and inline JS reducing HTTP requests. Not recommended if your site uses HTTP/2.

No: Breaks plugin — scripts depend on specific load order and wp_localize_script data.

Excluded JavaScript Files

Specify URLs of JavaScript files to be excluded from minification and concatenation (one per line).

Internal: The domain part of the URL will be stripped automatically. Use (.*).js wildcards to exclude all JS files located at a specific path. 3rd Party: Use either the full URL path or only the domain name, to exclude external JS.

tigoniq.com/chatbot(.*).js
dms-woo-inject(.*).js
dms-api-service(.*).js
dms-inventory-filtered(.*).js
/wp-content/plugins/tigon-dms-connect/assets/js/(.*).js

Load JavaScript deferred eliminates render-blocking JS on your site and can improve load time.

Careful: Test inventory pages + admin sync.

Excluded JavaScript Files (Deferred)

Specify URLs or keywords of JavaScript files to be excluded from defer (one per line).

/wp-content/plugins/tigon-dms-connect/assets/js/(.*).js
tigoniq.com/chatbot(.*).js
dms-woo-inject(.*).js
dms-api-service(.*).js
dms-inventory-filtered(.*).js

Delay JavaScript — No: Breaks dms-woo-inject.js — images won't load until user interaction.

Name		Name	Last commit message	Last commit date
assets		assets
includes		includes
mapped-logic		mapped-logic
src		src
templates		templates
vendor		vendor
.gitignore		.gitignore
DUPLICATE-PREVENTION-AUDIT.md		DUPLICATE-PREVENTION-AUDIT.md
README.md		README.md
REVIEW.md		REVIEW.md
composer.json		composer.json
dms-bridge-plugin.php		dms-bridge-plugin.php

Navigation Menu

Repository files navigation

TIGON DMS Connect

What It Does

Key Features

Multi-Path Inventory Sync

Schema Templates

Field Mapping System

Image Handling

7-Layer Duplicate Prevention

Product Feed Integration

Multi-Location Support

Admin Pages

REST API Endpoints

REST API Authentication

Shortcodes

Elementor Widgets

WooCommerce Customizations

Database Tables

Auto-Updates

Architecture

Requirements

CDN & Caching Configuration

CDN Exclusions

Never Cache URLs

Always Purge URLs

Cache Query Strings

Never Cache Cookies

Never Cache User Agents

CSS Files

Excluded CSS Files

JavaScript Files

Excluded JavaScript Files

Excluded JavaScript Files (Deferred)

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

TIGON DMS Connect

What It Does

Key Features

Multi-Path Inventory Sync

Schema Templates

Field Mapping System

Image Handling

7-Layer Duplicate Prevention

Product Feed Integration

Multi-Location Support

Admin Pages

REST API Endpoints

REST API Authentication

Shortcodes

Elementor Widgets

WooCommerce Customizations

Database Tables

Auto-Updates

Architecture

Requirements

CDN & Caching Configuration

CDN Exclusions

Never Cache URLs

Always Purge URLs

Cache Query Strings

Never Cache Cookies

Never Cache User Agents

CSS Files

Excluded CSS Files

JavaScript Files

Excluded JavaScript Files

Excluded JavaScript Files (Deferred)

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages