WordPress Plugin: Hello Event Again

Extend the possibilities of the Hello Event Plugin

Hello Event brings event management and ticket sales in an extremely easy way to any WordPress site!  Hello Event Again further extends the capabilities of Hello Event :

• Event organisers can follow ticket sales directly on the front-end event page.
• New Sidebar meta-box and a new shortcode to display the sidebar contents, for example in the widget area.
• It is possible to define categories, sub-categories, sub-sub-categories… of events. Most event details (description, excerpt, thumbnail, sidebar, location, …) will use information defined in the category as default for the events, making it even much easier and quicker to define new events.
• In the backend events are listed with sortable columns for category, start-date and end-date, making it easy to quickly get an overview and find what you are looking for.
• Many new powerful shortcodes help organising pages to present events to visitors, for example based on event categories.
• Event calendar uses category-defined colors allowing visitors to immediately recognize different events

Hello Event Again is a premium WordPress extension, currently available in beta

Pages used to present events on your site

To benefit from the full power of Hello Event Again without the need to make any changes to your theme it is recommended to set up three pages and use the shortcodes described below:

• Category List Page: this is the “table of contents” based on categories
• Category Show Page: presents the information of a category and links to either sub-categories, events, and/or the Category List Events Page
• Category List Events Page: list the events of a category, using the possibilities offered by the Hello Event plugin (list, tabbed list, calendar)

Category List Page

Purpose

Present event categories with clickable thumbnails and titles. A Category List Page will act as a graphical “table of contents” organized by event category. It is possible either to present all categories on a single page, or to have several pages, each presenting a subset of the categories.

Shortcodes

[hello-event-category-link] : Present one category. Use this shortcode when you want full control of which categories to show on a page and in which order.

• category : category slug
• link_to : slug. Slug of a Category Show Page. Required.
• show_title : Boolean. Controls whether to display the title or not. Optional, default=true
• title : String. Title to display instead of the category’s title. Titles are displayed under the tumbnails. Optional, default=null
• show_image : Boolean. Controls whether to display the thumbnail or not. Optional, default=true
• image_size : String. Image size to use. Optional, default=”thumbnail”
• widget_events : [‘no’, ‘always’, ‘if_leaf’]. Controls whether to enable the widget that shows a thumbnail and a link to a page with list of events of target category, with possibility to only do this if the target category is a leaf category. Optional, default=’if_leaf’
• link_to_the_events : page slug. Slug of a Category List Events Page. Required if the [hello-event-thumb-and-link] shortcode is used in a widget, or if the [hello-event-link-to-category-list-events] is used on the Category Show Page
• list_events : [‘no’, ‘always’, ‘if_leaf’]. Controls whether to list the events on the Category Show Page, with possibility to only do this if the target category is a leaf category.

[hello-event-category-links] : Same as above but presents all the top-level categories in alphabetic order. It is never the less  possible to disable a category by setting the selector “show on site” in the category defintion to “No”.

Category Show Page

Purpose

Present a category and its subcategories in the form of clickable thumbnails and titles. Only one such page needed.

Shortcodes

[hello-event-category-title] : Display the category name in a html tag

• category : category slug. Optional, default taken from the category GET parameter in the URL
• tag : String. HTML tag in which to embed the title. Optional, default=’h1′,
• before : String. Text that will preceede the category name in the the H1 tag. Optional, default=””
• after : String. Text that will follow the category name in the the H1 tag. Optional, default=”

[hello-event-category-show] : Display the category description

• category : category slug. Requied but default taken from the category GET parameter in the URL if present
• show_if_parent : Boolean. Controls whether to display the category description if the current category has sub-categories.  Optional, default=TRUE

[hello-event-subcategory-links] : Present the subcategories of a given category in a similar way to [hello-event-category-link]. The category to present can be provided in a parameter in the UR. This makes this shortcode perfectly well suited to use on a page which is the targeted by the link_to parameter in a [hello-event-category-link] shortcode (or even in a [hello-event-subcategory-links] shortcode in the case of a multi-level category hierarchy.

• category : category slug. Requied but default taken from the category GET parameter in the URL if present
• link_to : slug of a Category List Events Page.  Link target used by leaf categories. Required.
• link_text : String. Text to appear in the link to the Category List Events Page. Optional, default=”See upcoming events of this type”
• show_title : Boolean. Controls whether to display the title or not. Optional, default=true
• title : String. Optional title to display instead of the category’s title. Optional, default=null
• show_image : Boolean. Controls whether to display the thumbnail or not. Optional, default=true
• image_size : String. Image size to use. Optional, default=”thumbnail”
• list_events : [‘no’, ‘always’, ‘if_leaf’]. Controls whether to list the events of this category, with possibility to only list if the current category is a leaf category. Optional, default=’if_leaf’
• shortcode : String. Shortcode to be used to list the events of this category. Optional, default=”hello-event-list”

[hello-event-link-to-category-list-events] : Show a link to the Category List Events Page, which will include the category as parameter. The link is only shown if the category has sub-categories.

• category : category slug. Requied but default taken from the category GET parameter in the URL if present
• link_to : slug of a Category List Events Page.  Link target used by leaf categories. Required but default taken from the link_to_the_events GET parameter in the URL if present
• link_text : String. Text to appear in the link to the Category List Events Page. Optional, default=”See all the events of this type”

Category List Events Page

Purpose

Show the events of a category as a list, a tabbed list and/or a calendar

Shortcodes

Ths page will use any of the shortcodes defined in the Hello Events plugin:

[hello-event-list]

[hello-event-tab]

[hello-event-calendar]

Notice: These three shortcodes use a category filter. If the URL used to display the page with these shortcodes contains a category parameter (category slug) only events of that category will be considered.

Events

The Hello Event Again plugin adds a new meta-box and new shortcodes to the events defined in the Hello Event plugin.

New Metabox: Sidebar

The content of this metabox, which is defined both for events and event categories, is displayed with the help of the shortcode [hello-event-sidebar].

New or modified Shortcodes

[hello-event-category-content] : Used in the content of an event to include the content of its category. In the case of hiearchical categories this is a concatenation of content from the root category down. When the content of an event is left blank the category content will always be included, therfore this shortcode is only necessary when

[hello-event-sidebar] : Displays the sidebar content for a category or and event. For a category this is a concatenation of the sidebar content of the category itself preceeded by the content of all its ancestors in the case of hiearchical categories. For an event this is the sidebar content of the event, in a smilar way to the xx shortcode.

Widgets

To install the widgets, use the Custom HTML standard widget and insert one the following shortcodes in the widget

[hello-event-thumb-and-link] : This shortcode will only be visible on pages that display a description of an event category. It will display the category thumbnail and a text string in the widget area. The thumbnail plus the text string is a link to a page that should shows the events of the category. The content of that page will thus use a shortcode like [hello-event-list], [hello-event-tab], or [hello-event-calendar]

• link_text : String. The text that will be shown under the thumbnail. Optional, default = “See the events”
• link_to : page slug. The slug of the page that will show the events of categories. Required, but if not present it will be taken from the link_to GET parameter in the URL

[hello-event-sidebar] : See description above. When used in the widget area the shortcode will output content only when displaying and event of an event category.