WordPress.org
Get WordPress
WordPress.org

Plugin Directory

AgileTix Site Sync

AgileTix Site Sync

By agiletixpluginuser
Download

Description

AgileTix Site Sync connects your WordPress site to your AgileTix account. The plugin automatically creates, updates, and manages WordPress posts from your event and show data, keeping your site synchronized with your ticketing system without manual data entry.

Key Benefits:

  • Automatic Post Management: Automatically create and update WordPress posts from your AgileTix show data
  • Smart Content Generation: Generates rich post content including media carousels, event descriptions, showtimes, and venue information
  • Flexible Mapping: Configure metadata mapping, taxonomy assignments, and content layout in the admin settings
  • Theme Integration: Integrates with themes such as Event Champ and Amy Movie, or use custom post types
  • Event Display Tools: Shortcodes for filtered event lists and coming-soon / now-showing banners
  • Bundled Styling: Ships fixed front-end CSS for plugin shortcodes and event markup; further styling can be done in your theme

Requirements

Before installing AgileTix Site Sync, ensure your WordPress installation meets the following requirements:

  • WordPress version 6.7 or higher
  • PHP version 7.4 or higher
  • Active internet connection for API communication with AgileTix
  • Valid AgileTix credentials (Domain, Corp Org ID, EPGID, and GUID)
  • Administrator access to your WordPress site

The plugin receives scheduled data refreshes from AgileTix via external pings (configure under Credentials after validating your account). Action Scheduler is bundled for background batch processing during each refresh. If WooCommerce is installed, the plugin uses its existing Action Scheduler instance instead.

Features

AgileTix Site Sync provides a comprehensive set of features for managing event content on your WordPress site:

  • Automatic Post Creation and Updates: Creates WordPress posts from your AgileTix show data and keeps them synchronized
  • Media Carousel Generation: Interactive media carousels for event images and videos in post content
  • Event List Shortcode: Use [agiletix_event_list] for filtered, sortable event listings
  • Banner Shortcodes: [agiletix_coming_soon_banner] and [agiletix_now_showing_banner] for scrolling event displays
  • Bundled Front-End CSS: Fixed plugin styles for shortcodes and event markup (no admin CSS editor)
  • Theme Integration Options: Event Champ, Amy Movie, or custom post type mapping
  • Manual and Automatic Data Refresh: Manual utility tools plus optional AgileTix webhook pings
  • Action Scheduler Integration: Background batch processing for large datasets
  • Advanced Configuration: Metadata mapping, taxonomy assignments, and content layout blocks
  • Post Status Management: Draft or publish on create, with optional culling of outdated posts
  • Block Editor Support: Post content uses WordPress block format where applicable

External services

This plugin connects to AgileTix-hosted services when you configure credentials and use related features.

AgileTix domain location service

  • What: Resolves your organization’s AgileTix API URL and Web URL from your Domain and Corp Org ID
  • When: On credential save/validation, entry point lookup, and whenever the plugin needs your ticketing base URLs
  • Where: https://prod1.agileticketing.net/ATSLocation/Domain.svc/JSON/GetDomainServices for production domains, or https://qa.agiletix.com/ATSLocation/Domain.svc/JSON/GetDomainServices when your domain is configured for QA
  • Data sent: Domain, Corp Org ID, and application key parameters required by the location service
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

AgileTix refresh webhook registration (optional)

  • What: Registers your WordPress site refresh endpoint with AgileTix so external pings can trigger data sync when automated refreshes are enabled
  • When: After credentials are saved and validated successfully on a production site (not staging)
  • Where: Your resolved AgileTix API URL (Sales.svc/JSON/WordPressWebHook on your organization’s API host, or https://qa.agiletix.com/API/ for QA domains)
  • Data sent: Corp Org ID, your WordPress REST refresh URL, and the application secret used to authenticate refresh requests
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

AgileTix show/event feed (JSON)

  • What: Retrieves show and event data from your resolved AgileTix Web URL (feed.ashx) for post sync, shortcodes, and banners; may include image URLs and optional HTML fragments (ExtraHTML, MediaEmbed in AdditionalMedia) that the plugin sanitizes before display
  • When: On credential validation, manual or automatic data refresh, batch processing, and when the coming-soon feed is enabled
  • Data sent: Entry point identifiers (GUID, EPG ID, or EPG tag), feed query parameters, and related request context needed to retrieve show data
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

AgileTix-hosted media

  • What: Loads event images and carousel media from URLs provided in AgileTix feed data (AgileTix CDN or your organization’s ticketing domain)
  • When: During post creation/update and on the front end when media carousels or event images are displayed
  • Data sent: Standard HTTP requests for image/media URLs included in feed data (no additional data beyond normal media loading)
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

AgileTix integration widget (optional)

  • What: When the integration widget is enabled under Config, the plugin loads AgileTix’s agile_integrate.ashx script from your organization’s resolved Web URL. That script integrates your WordPress site with the AgileTix sales system by wiring purchase/sign-in/cart flows into page elements (including sales iframes/modals for ticketing). Related resources may also load from your ticketing domain (such as widget CSS) and, if needed, jQuery from code.jquery.com.
  • When: On front-end pages when the integration widget option is turned on
  • Where: {resolved Web URL}agile_integrate.ashx
  • Data sent: Organization ID, entry point group ID, widget target/mode, and browser context required for ticketing UI; additional data may be sent when users interact with sign-in, cart, or purchase flows
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

AgileTix Entry Point Lookup (admin)

  • What: An admin Utility-tab helper that lists the entry points linked to a given Entry Point Group (EPG), so you can choose which content to sync without opening the AgileTix desktop app or website. As an implementation detail, it makes a one-time server-side request to the same agile_integrate.ashx endpoint and reads only the entry-point menu list (AgileMenu) from the response; it does not enable or run the front-end sales integration widget.
  • When: Only when an administrator runs Entry Point Lookup in the WordPress admin (Utility tab)
  • Where: {resolved Web URL}agile_integrate.ashx
  • Data sent: Corp Org ID, Entry Point Group ID, and fixed query parameters (target=agile_frame, mode=popup)
  • Terms of service: https://www.agiletix.com/terms-and-conditions
  • Privacy policy: https://www.agiletix.com/privacy-statement

Admin settings preview (sample data)

  • What: Displays read-only example feed JSON on plugin settings screens to illustrate data structure
  • When: Only in the WordPress admin on Theme and Content settings tabs
  • Data sent: None; sample data is static and does not call an external API

Bundled third-party library

This plugin bundles Action Scheduler 4.x (WooCommerce) under the GPL v2 or later. Action Scheduler runs scheduled refresh jobs on your site and does not contact external services by itself. If WooCommerce is already installed, the plugin uses the existing Action Scheduler copy instead of loading a second instance.

Installation

  1. For absolute safety, ensure you have a backup of your site before making any changes.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress, starting by pressing “Add New Plugin”.
  3. Continue by pressing “Upload Plugin”.
  4. Drag and drop or select the entire agiletix-site-sync.zip when prompted.
  5. Click “Install Now” and wait until you are prompted with “Active Plugin”.

Post-Installation Setup:

After activation, navigate to “AgileTix Options” in your WordPress admin menu to begin configuration:

  1. Go to the Credentials tab and enter your AgileTix connection details
  2. Save your credentials – the plugin will validate them automatically
  3. Once validated, proceed to the Config tab to set your post creation preferences
  4. We recommend starting with post status set to “Draft” for testing purposes
  5. Use the Utility tab to perform a manual refresh and test post creation
  6. Review the created posts and adjust settings in the Content and Theme tabs as needed
  7. Once satisfied, change post status to “Publish” and enable automatic data refreshes

FAQ

Why am I getting an error when I save my credentials?

The plugin validates your credentials when you save them. Common causes of credential errors include:

Missing Required Fields:
* Ensure all required fields are filled: Domain, Corp Org ID, and Secret
* You must provide either EPGID and GUID together, OR EPGTAG (not both)

Invalid Entry Point:
* The EPGID/GUID or EPGTAG must point to at least one show in your AgileTix system
* If you receive a “no shows found” error, verify that your EPGID/GUID or EPGTAG is correct and that it references shows in your system
* Contact your AgileTix administrator if you’re unsure about your entry point identifiers

API Connection Issues:
* Check that your WordPress site has internet connectivity
* Verify that your server is not blocking outbound API calls

Why can’t I enable automated data refreshes on a staging site?

Due to security and data integrity concerns, automatic data refreshes are disabled for staging sites.

Using Manual Refresh Tools:
* Navigate to the Utility tab in AgileTix Options
* Use “Fast Refresh ATS Data” to reformat existing data without fetching new data (useful for testing configuration changes)
* Use “Full Refresh ATS Data” to fetch new data from AgileTix and recreate all posts (useful for complete testing)

For Production Sites:
Automatic data refreshes are available on production sites. Once you’ve tested your configuration on staging and are satisfied with the results, you can enable automatic refreshes on your production site.

Why are my posts not appearing on my site?

Check Post Status:
* Navigate to the Config tab and verify your post status setting
* If set to “Draft”, posts will be created but not visible to public visitors
* Change to “Publish” to make posts visible (after testing)

Verify Post Creation:
* Go to WordPress Posts (or your configured post type) in the admin area
* Check if draft posts were created
* If no posts exist, perform a manual refresh from the Utility tab

Check Post Type:
* Verify that you’re looking in the correct post type (agile_post, event, or your custom post type)
* The post type is configured in the Theme tab

Permissions:
* Ensure your user account has permission to view the post type
* Check that the post type is publicly queryable in your theme configuration

Why are my posts not updating automatically?

Automatic Refresh Status:
* Verify that automatic data refreshes are enabled (not available on staging sites)
* Confirm AgileTix external pings are reaching your site (see Credentials tab)
* Check the Advanced tab to see if Action Scheduler tasks are running

Action Scheduler:
* Navigate to the Advanced tab to view Action Scheduler status
* Large datasets are processed in the background – check the queue for pending actions
* If actions are stuck, you may need to manually trigger them or check for errors

Credentials:
* Ensure your credentials are still valid (check the Credentials tab)
* Invalid credentials will disable automatic refreshes

Manual Refresh:
* Use the Utility tab to perform a manual refresh if automatic updates aren’t working
* This can help identify if the issue is with automatic scheduling or data fetching

The shortcode [agiletix_event_list] is not displaying events

Verify Posts Exist:
* Ensure that posts have been created and are published (or visible to the current user)
* Check that posts have the ATS_EventID meta field (this identifies them as AgileTix events)

Check Post Type:
* The shortcode uses the post type configured in your Theme tab by default
* You can override this with the posttype attribute: [agiletix_event_list posttype="your_post_type"]
* Verify the post type matches the one used when creating posts

Theme Compatibility:
* Some themes may need additional CSS for proper display
* The plugin ships bundled CSS for shortcode markup; your theme may still need layout adjustments
* Review browser console for JavaScript errors that might prevent display

Cache Issues:
* Clear your WordPress cache and browser cache
* If using a caching plugin, purge the cache after creating or updating events

The event list filters are not working

JavaScript Requirements:
* Ensure JavaScript is enabled in your browser
* Check browser console for JavaScript errors
* Verify that your theme is not conflicting with the shortcode’s JavaScript

Post Meta Data:
* Filters rely on post meta data and taxonomies
* Ensure events have genre taxonomies assigned (if using genre filtering)
* Verify that event dates are properly stored in post meta

CSS Issues:
* Check that filter buttons are visible (they may be hidden by theme CSS)
* Inspect the page to ensure filter containers are present in the HTML

The media carousel is not displaying

Media Data:
* Check that media embeds are properly formatted in the ATS data
* Empty or invalid media data will result in no carousel display

Content Generation:
* The carousel is automatically generated as part of post content
* Check the Content tab to ensure media carousel generation is enabled
* Review generated post content to see if carousel HTML is present

Theme Compatibility:
* Some themes may need additional CSS for carousel display
* Use your theme’s CSS to adjust carousel layout if needed

I’m experiencing performance issues with large datasets

Action Scheduler:
* The plugin uses Action Scheduler for efficient background processing
* Navigate to the Advanced tab to monitor Action Scheduler performance
* Large datasets are processed in batches to prevent timeouts

Server Resources:
* Ensure your server has adequate PHP memory and execution time limits
* Consider increasing max_execution_time and memory_limit in PHP settings
* Check server logs for timeout or memory errors

Monitoring:
* Check the Advanced tab for Action Scheduler queue status
* Monitor WordPress debug logs for processing information
* Use the Utility tab to see last known runtime information

How do I integrate with my theme?

Theme Tab Configuration:
* Navigate to the Theme tab in AgileTix Options
* Select your integration type:
* None: Uses default agile_post post type
* Event Champ: Integrates with Event Champ theme
* Custom: Configure your own custom post type
* Amy Movie: Integrates with Amy Movie theme

Custom Post Types:
* For custom integration, specify your post type slug
* Configure taxonomy mappings (e.g., genres, categories)
* Set up custom field mappings in the Theme tab

Metadata Mapping:
* Use the Theme tab to map ATS data fields to WordPress meta fields
* Configure taxonomy assignments for categories, tags, and custom taxonomies

Testing:
* Perform manual refreshes to verify data mapping
* Adjust mappings in the Theme tab as needed

Best Practices:
* Always backup your site before making configuration changes
* Test configuration changes with draft posts first
* Use manual refreshes during initial setup and testing
* Monitor the Action Scheduler in the Advanced tab for large datasets
* Keep your WordPress and PHP versions up to date

Reviews

There are no reviews for this plugin.

Contributors & Developers

“AgileTix Site Sync” is open source software. The following people have contributed to this plugin.

Contributors

Translate “AgileTix Site Sync” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.6

  • Prefix WordPress feed as agile_coming_soon; rename activate/deactivate bootstrap functions to agile_tix_*
  • Prefix admin coming soon filter/column, metabox IDs, reset nonce, REST error code, and refresh button IDs
  • Rename public JS globals from ats_* to agile_*

1.3.5

  • Remove remote image URLs from admin sample JSON preview data
  • Replace remote getimagesize() with WordPress HTTP API in Amy Movie integration
  • Prefix genre taxonomy as agile_genre (with one-time migration) and ExecutionTime as agile_tix_ExecutionTime
  • Register agiletix_* shortcodes (replacing legacy ats_* tags)

1.3.4

  • Document Entry Point Lookup server-side agile_integrate.ashx requests in README external services
  • Harden theme integration type register_setting sanitization with sanitize_key and strict whitelist

1.3.3

  • Upgrade bundled Action Scheduler to 4.x
  • Preserve raw characters when saving the credential secret (no sanitize_text_field on passwords)
  • Expand README external services documentation; remove obsolete dev URL comments from source

1.3.2

  • Fix coming soon feed culling deleting main feed posts after a full refresh on new installs
  • Fix coming soon fast refresh creating duplicate posts; normalize event ID lookups
  • Skip coming soon processing when an event is already in the main (now showing) feed; stop tagging those posts with ATS_ComingSoonDate

1.3.1

  • WordPress.org review: sanitize AgileTix feed HTML (MediaEmbed, ExtraHTML) and validate integration widget script host
  • Removed bundled Ace editor; admin feed preview uses read-only sample JSON
  • Fixed register_setting sanitization for custom post type mapping; removed internal utility options from Settings API
  • Removed global WP_IMPORTING during refresh; batch processing uses scoped defer helpers
  • Expanded README external services documentation

1.3.0

  • WordPress.org submission release: rebranded as AgileTix Site Sync
  • Credential validation on save and manual verify on the Utility tab
  • Security: settings sanitization and shortcode escaping
  • Removed admin Style tab; bundled public CSS; enqueued shortcode assets
  • README and release packaging updates for WordPress.org review
  • Fixed location service handling when the API returns invalid JSON

1.0

  • Initial Release

Meta

  • Version 1.3.6
  • Last updated 19 hours ago
  • Active installations Fewer than 10
  • WordPress version 6.7 or higher
  • Tested up to 7.0.2
  • PHP version 7.4 or higher
  • Tag
  • Advanced View

Ratings

No reviews have been submitted yet.

Your review

See all reviews

Support

Got something to say? Need help?

View support forum