{"id":343484,"date":"2026-07-21T21:52:18","date_gmt":"2026-07-21T21:52:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/civievent-block\/"},"modified":"2026-07-21T21:51:51","modified_gmt":"2026-07-21T21:51:51","slug":"civievent-block","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/civievent-block\/","author":23143885,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.0.2","requires":"6.6","requires_php":"7.4","requires_plugins":null,"header_name":"Events Listing Block for CiviCRM","header_author":"Ryan Morash","header_description":"Display public CiviCRM events with a dynamic Gutenberg block.","assets_banners_color":"","last_updated":"2026-07-21 21:51:51","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/ryanmorash\/civievent-block","header_author_uri":"https:\/\/github.com\/ryanmorash","rating":0,"author_block_rating":0,"active_installs":0,"downloads":50,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"ryanmorash","date":"2026-07-21 21:51:51"}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":{"civievent-block\/events":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"civievent-block\/events","version":"1.0.2","title":"CiviCRM Events","category":"widgets","icon":"calendar-alt","description":"Display a list or a single upcoming public CiviCRM event.","keywords":["CiviCRM","events","calendar"],"textdomain":"civievent-block","attributes":{"displayMode":{"type":"string","default":"list"},"heading":{"type":"string","default":"Upcoming Events"},"headingLevel":{"type":"number","default":2},"limit":{"type":"number","default":5},"offset":{"type":"number","default":0},"eventTypeId":{"type":"number","default":0},"showSummary":{"type":"boolean","default":false},"showTime":{"type":"boolean","default":true},"showRegistration":{"type":"boolean","default":true},"showViewAll":{"type":"boolean","default":false},"showCity":{"type":"boolean","default":false},"stateDisplay":{"type":"string","default":"none"},"showCountry":{"type":"boolean","default":false},"locationSeparator":{"type":"string","default":", "},"emptyMessage":{"type":"string","default":"No upcoming events."}},"supports":{"align":["wide","full"],"anchor":true,"color":{"background":true,"text":true,"link":true},"html":false,"spacing":{"margin":true,"padding":true},"typography":{"fontSize":true,"lineHeight":true}},"styles":[{"name":"default","label":"Cards","isDefault":true},{"name":"divided","label":"Divided"},{"name":"striped","label":"Striped"}],"editorScript":"file:.\/index.js","editorStyle":"file:.\/editor.css","style":"file:.\/style-index.css","render":"file:.\/render.php"}},"tagged_versions":["1.0.2"],"block_files":["\/tags\/1.0.2\/blocks\/events\/index.js","\/tags\/1.0.2\/blocks\/events\/editor.css","\/tags\/1.0.2\/blocks\/events\/style-index.css"],"assets_screenshots":[],"screenshots":[]},"plugin_section":[172757],"plugin_tags":[1220,416,13994,1486,148076],"plugin_category":[40],"plugin_contributors":[272703],"plugin_business_model":[],"class_list":["post-343484","plugin","type-plugin","status-publish","hentry","plugin_section-block","plugin_tags-block","plugin_tags-calendar","plugin_tags-civicrm","plugin_tags-events","plugin_tags-gutenberg","plugin_category-calendar-and-events","plugin_contributors-ryanmorash","plugin_committers-ryanmorash"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/civievent-block.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Events Listing Block for CiviCRM adds a server-rendered CiviCRM Events block. Event information is loaded from CiviCRM whenever the page is viewed, so published content stays current without resaving the post.<\/p>\n\n<p>The block supports:<\/p>\n\n<ul>\n<li>Lists of up to 20 upcoming events or one upcoming event.<\/li>\n<li>Event type filtering and single-event offsets.<\/li>\n<li>Optional summaries, times, registration links, and a view-all link.<\/li>\n<li>Optional city, state\/province, and country output.<\/li>\n<li>Card, divided, and striped styles plus standard WordPress color, spacing, typography, alignment, and anchor controls.<\/li>\n<li>A live server-rendered editor preview.<\/li>\n<\/ul>\n\n<p>This plugin requires CiviCRM with the CiviEvent component enabled. CiviCRM is not hosted in the WordPress.org Plugin Directory and must be installed separately.<\/p>\n\n<p>If CiviCRM is not active, Events Listing Block for CiviCRM remains active without causing a fatal error. Administrators see guidance on the Plugins screen, editors see a configuration message in the block preview, and the block produces no public output until CiviCRM is available.<\/p>\n\n<h3>Trademark<\/h3>\n\n<p>CiviCRM is a registered trademark of CIVICRM LLC.<\/p>\n\n<!--section=installation-->\n<ol>\n<li><a href=\"https:\/\/docs.civicrm.org\/installation\/en\/latest\/wordpress\/\">Install and activate CiviCRM<\/a>, then confirm that the CiviEvent component is enabled.<\/li>\n<li>Upload the <code>civievent-block<\/code> directory to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate Events Listing Block for CiviCRM.<\/li>\n<li>Insert the CiviCRM Events block in the block editor and choose its settings in the block sidebar.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20events%20are%20displayed%3F\"><h3>Which events are displayed?<\/h3><\/dt>\n<dd><p>The block displays active, public, non-template events whose start date is today or later, ordered by start date. Developers can adjust the CiviCRM API parameters with the <code>civievent_block_query_args<\/code> filter.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20markup%20or%20query%3F\"><h3>Can I customize the markup or query?<\/h3><\/dt>\n<dd><p>The <code>civievent_block_query_args<\/code>, <code>civievent_block_events<\/code>, and <code>civievent_block_registration_label<\/code> filters allow theme or plugin code to adjust the query, event records, and registration label.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20civicrm%20is%20not%20active%3F\"><h3>What happens if CiviCRM is not active?<\/h3><\/dt>\n<dd><p>The plugin can still be activated safely. It shows a warning to administrators on the Plugins screen and a configuration message to editors. Visitors see no broken markup or error message; the block begins displaying events after CiviCRM is installed and active.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Rename the plugin to Events Listing Block for CiviCRM while retaining the <code>civievent-block<\/code> slug.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fix block style selectors after the block namespace change.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Change block namespace to match plugin slug<\/li>\n<li>Remove the unsupported WordPress.org dependency header for CiviCRM.<\/li>\n<li>Handle a missing CiviCRM installation with contextual administrator and editor guidance.<\/li>\n<li>Document the external CiviCRM installation requirement.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release with dynamic list and single-event modes.<\/li>\n<\/ul>","raw_excerpt":"Display upcoming public CiviCRM events in a dynamic Gutenberg block.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/343484","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=343484"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ryanmorash"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=343484"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=343484"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=343484"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=343484"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=343484"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=343484"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}