Once you've downloaded the zip file from github, you're ready to upload it to your Joomla extensions page and install the plugin.
First, visit the Upload Package File tab from your Joomla Extension Manager, and select the Upload & Install button shown in the screenshot below:
Go to https://developers.facebook.com/apps register and Add a New App for website, choose a name for your App, and add you domain to settings.
If you want to enable rsvp buttons in your website you have to add Item (rsvp_events) in Review of your Facebook App and wait for approval.
For each field if you hover the mouse pointer on the relative label, you can see a tooltip with a description.
In the basic settings you can see:
-
You have to copy AppId and Secret Key from your Facebook App;
-
Facebook Page Id is the page ID or profile ID, you can get it by simply change www with graph on your page/profile url, for example www.facebook.com/p2warticles will be graph.facebook.com/p2warticles;
-
Show events allow you to select which events to show
-
You can enable microdata for new Events or all events, but for Google is better only new.
Advanced options will come with an easy and intuitive settings with accordions sections. Each field have a tooltip description, you can see it by hover the label with the pointer, how you can in the following image:
All these params will override plugin settings and are case sensitive.
| Params for Fb General Settings | Value | Description | Possible values |
| fbUserName | number | Facebook page/profile username or id | ∞ |
| showEvents | string | New: only actual and future events; Past: past events | new, past, all |
| limitEvents | number | Number of Events to show | ∞ |
| orderEvents | string | Order | ASC, DESC |
| enableMicrodata | string | Add microdata for SEO, for Google best option is New | false, all, new |
| Params for Fields | |||
| showFields | array | Fields to select and order | title, image, date, description, ticket_uri, venue, rsvp, link, update_time, attendants |
| Params for Title | |||
| linkedTitle | boolean | Add link to title | true, false |
| titleTag | string | Choose a tag for event title | h1, h2, h3, p, div |
| titleClass | string | Choose a css class name | ∞ |
| Params for Picture | |||
| pic | string | You can use this to get a pre-specified size of picture. | cover, small, normal, large, square |
| picClass | string | Choose a css classname | ∞ |
| coverSetting | string | Facebook Cover proportion | cover, full |
| Params for Date | |||
| dateLang | string | for week days names en_EN format on UNIX Server, leave empty or English on Windows SERVER see php.net | |
| timeSeparator | string | Time separator icon or text | |, url, -, ∞, etc. |
| toText | string | To Text | ∞ |
| lastUpdateText | string | Last Update Text | ∞ |
| dateClass | string | Choose a css class name | ∞ |
| updateTimeClass | string | Choose a css class name | ∞ |
| fullDateFormat | string | Choose full date format see php.net | ∞ |
| dateFormat | string | Choose date format for events that start and end in a single day see php.net | ∞ |
| timeFormat | string | Choose time format see php.net | ∞ |
| dateFormatUpdate | string | Choose date format for last update date see php.net | ∞ |
| Params for Description | |||
| descriptionClass | string | Choose a css class name | ∞ |
| descriptionLimit | number | Limit description length | ∞ |
| Params for TicketUrl | |||
| ticketDivClass | string | Choose a css class name | ∞ |
| ticketLinkClass | string | Choose a css class name | ∞ |
| ticketText | string | Text of the link users can visit to buy a ticket to the event | ∞ |
| Params for Location | |||
| locationText | string | Location | ∞ |
| locationClass | string | Choose a css class name | ∞ |
| Params for RSVP Buttons | |||
| rsvpClass | string | Choose a css class name | ∞ |
| btnAttend | boolean | Active this button | true, false |
| btnUnsure | boolean | Active this button | true, false |
| btnDeclined | boolean | Active this button | true, false |
| btnTextAttend | string | Attend value | ∞ |
| btnTextUnsure | string | Unsure value | ∞ |
| btnTextDeclined | string | Declined value | ∞ |
| btnClassAttend | string | Choose a css class name | ∞ |
| btnClassUnsure | string | Choose a css class name | ∞ |
| btnClassDeclined | string | Choose a css class name | ∞ |
| Params for Link | |||
| linkText | string | Link Text | ∞ |
| linkClass | string | Choose a css class name | ∞ |
| Params for UserList | |||
| loadingImg | string | Insert a link to a loading picture | ∞ |
| limitUser | number | Insert a limit of users to show per event | ∞ |
| linkedUser | boolean | Link to each user profile | true, false |
| attendantStatus | string | which users status to show | attending, maybe, declined |
| Single event with Eid | |||
| id | number | If you want to show only a single event | ∞ |
Show events with plugins settings:
{fbevents}
Show a specific event:
{fbevents id=12125123421}
Show only new events with title and date:
{fbevents showEvents=new|showFields=title,date,venue}
Show only new events with title and user attetting:
{fbevents showEvents=new|showFields=title,attendants|attendantStatus=attending}
-
jQuery 1.7+
-
Php 5.4+
-
Facebook **appid **and secret key
-
Joomla 3.x+
Copyright (c) 2014 Serafino Bilotta
Licensed under the GNU/GPL license.