JCal Pro allows you to embed events in Joomla content with one click.
This enabled you to show JCal Pro event outside the confines of a calendar-based display.
How to Embed Single Events
- After installing JCal Pro, go to edit a Joomla article. Click the "Event" button in your editor:
- You'll see a pop-up window with a list of your events. Choose your event and which details you want to display:
- After clicking on your chosen event, you'll see the event inside your article, as in this image:
How to Embed Multiple Events
- To display upcoming or recent events in a Joomla article, simply place the following tag in your article where you want the events to appear:
{jcal_latest}
There is no button to insert these shortcodes. You type these shortcodes directly into your articles.
Additional Options for Embeds
For maximum flexibility, use the following parameters in your tags. You may use them alone or in combination. These parameters will then override the default settings.
- cat, category [comma-seperated list of category IDs listed in the category manager]
- show_category [true/false]
- date, show_date [true/false]
- description, show_description [true/false]
- readmore, show_readmore [true/false]
- time, show_time [true/false]
- list_limit, max_upcoming [max # of upcoming events (forces range to ‘upcoming’)]
- max_recent [max # of recent events (forces range to ‘past’)]
- range (see possible values below)
Range | Description |
all | All events |
last_30 | Last 30 days |
last_month | Last month |
last_week | Last week |
last_year | Last year |
next_2_months | Next 2 months |
next_2_weeks | Next 2 weeks |
next_30 | Next 30 days |
next_3_months | Next 3 months |
next_3_weeks | Next 3 weeks |
next_month | Next month |
next_week | Next week |
next_year | Next year |
ongoing | Ongoing |
past | Started in past |
past_end | Ended in past |
this_month | This month |
this_week | This week |
this_year | This year |
today | today |
tomorrow | Tomorrow |
upcoming | Starts in the future |
upcoming_end | Ends in the future |
yesterday | Yesterday |
Let's see some examples of those shortcodes in action. Here's how to create a list of specific events, using the ID of each event:
{jcal_latest}
Here's how to create a list of upcoming events from specific calendars:
{jcal_latest cat=2,3}
Here's how to create a list of upcoming events with the description visible & the readmore link hidden:
{jcal_latest show_description=true readmore=false}
Here's how to build a list of the next 5 upcoming events:
{jcal_latest max_upcoming=5}
This shortcode will list the last 2 recent events:
{jcal_latest max_recent=2}
List of upcoming events in categories #2 and #3:
{jcal_latest cat=2,3}
It's possible to combine as many options as you want. For example:
{jcal_latest cat=1,2 max_recent=4 show_readmore=true show_description=true}