CitySpark Events and Embeds
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 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. 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: Log in to admin.cityspark.com and configure a Custom Domain (e.g. events.yoursite.com). Follow the DNS instructions provided there to point that hostname at CitySpark’s servers. 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). 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.
Syntax-highlighting Code Block (with Server-side Rendering)
This plugin extends the Code block in WordPress core to add syntax highlighting which is rendered on the server. Pre-existing Code blocks on a site are automatically extended to include syntax highlighting. Doing server-side syntax highlighting eliminates the need to enqueue any JavaScript on the frontend (e.g. Highlight.js or Prism.js) and this ensures there is no flash of unhighlighted code (FOUC?). Reducing script on the frontend improves frontend performance, and it also allows for the syntax highlighted code to appear properly in AMP pages as rendered by the official AMP plugin (see also ampproject/amp-wp#972) or when JavaScript is turned off in the browser. This extended Code block uses language auto-detection to add syntax highlighting, but you can override the language in the block’s settings sidebar. (There is currently no syntax highlighting of the Code block in the editor, but see #8.) The plugin supports all programming languages that highlight.php supports (being a port of highlight.js). The Code block also is extended to support specifying lines to highlight which get marked up with mark elements (including in RSS feeds). There is also a checkbox for whether to show line numbers on the frontend (with the numbers being non-selectable). Lastly, given inconsistencies across themes regarding whether lines in a Code block should be wrapped, this plugin adds styling to force them to no-wrap by default, with a checkbox to opt in to wrapping when desired. For advanced usage, please see the plugin wiki. This plugin is developed on GitHub. See list of current issues with the plugin. Please feel free to file any additional issues or requests that you may come across. Pull requests are welcome. See contributing information. Credits This is a fork of Code Syntax Block by Marcus Kazmierczak (mkaz), which is also available on WordPress.org. Copyright (c) 2018 Marcus Kazmierczak. Licensed under GPL 2.0 or later. highlight.php is released under the BSD 3-Clause License. Copyright © 2006-2013, Ivan Sagalaev (maniac@softwaremaniacs.org), highlight.js (original author). Copyright © 2013, Geert Bergman (geert@scrivo.nl), highlight.php