=== CitySpark Events and Embeds ===
Contributors:      tydavis, cityspark
Tags:              block, event, calendar, business listings, listings
Tested up to:      6.9
Requires at least: 5.2
Requires PHP:      7.2
Stable tag:        0.1.3
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

&copy; 2026 CitySpark. All Rights Reserved

== Description ==

CitySpark Inc. is the leading event listing and promotion
platform for publishers. This plugin integrates the
CitySpark platform into WordPress, allowing you to easily
display your CitySpark calendar along with business
listings and upcoming best of content.

This plugin requires a CitySpark account. Go to [CitySpark.com](https://cityspark.com)
for more info.

External services

This plugin embeds scripts on the page that provide
access to CitySpark, Inc's services, including displaying
community events in your area and allowing users to
log into the CitySpark system to bookmark events. Usage
of the plugin by a publisher requires a CitySpark subscription
and the embedded scripts can be configured in the CitySpark
Admin site.

This service is provided by "CitySpark, Inc": [terms of use](https://cityspark.com/terms-of-use/).

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/cityspark-wp-plugin` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress

## Configuring the settings

Before adding a block to the page, make sure to update
the CitySpark Admin Page Settings. The settings configured
here are required for the correct operation of plugin, and
without them you may run into undesired 404 errors.

In the CitySpark Event Calendar Settings page on the
WordPress admin site, add a new "Placement URL" for
each Portal and List Page block you intend to add to
your site. Include the Placement URL and the Script
ID just as you see on the CitySpark Admin site.

## Adding the block

You can add a CitySpark Block to any page or post 
with the Gutenberg block editor. Directions for
the different kind of blocks are outlined below.

### Portal and List Page Blocks

After adding a CitySpark Portal or List Page Block to
any page or post with the WordPress Gutenberg editor,
insert the `Script ID` that matches the script that
you want from the CitySpark admin page, and you should
see the block show up in the preview (currently only
available for CitySpark Portal blocks).

### Widget Blocks

After adding one or more CitySpark Widget Blocks to
a page or post with the WordPress Gutenberg editor,
insert the `Widget ID` that matches the widget
you want from the CitySpark admin page.

## Custom Hostname

If ad-blockers on your visitors' browsers are preventing
the CitySpark portal script from loading, you can serve
it through your own domain instead. To set this up:

1. Log in to [admin.cityspark.com](https://admin.cityspark.com)
   and configure a Custom Domain (e.g. `events.yoursite.com`).
2. Follow the DNS instructions provided there to point
   that hostname at CitySpark's servers.
3. In the CitySpark Event Calendar Settings page in your
   WordPress admin, find the **Custom Hostname** section
   and enter just the hostname — no `https://` prefix
   (e.g. `events.yoursite.com`).
4. Click **Save Custom Hostname**. The plugin will now
   load the portal script from your domain instead of
   `portal.cityspark.com`.

Leave the field blank at any time to revert to the default
CitySpark domain.


== Screenshots ==

1. CitySpark Calendar and other Embeds can be easily incorporated via the Gutenberg Editor.
2. A sample from the settings page.

== Changelog ==

= 0.1.3 =
* Added XML sitemap integration: CitySpark event sitemaps are automatically fetched and injected into your site's active sitemap system (WordPress core, Yoast SEO, RankMath, or AIOSEO), refreshed daily via filesystem cache.
* Added Custom Hostname support: serve the CitySpark portal script from your own domain to prevent ad-blockers from interfering with event content.

= 0.1.2 =
* Handling of OpenGraph tags for details of pages of events
* Added plugin version attribute to script tags used in blocks

= 0.1.1 =
* Minor bug fixes

= 0.1.0 =
* Release

