JCal Pro allows you to delegate frontend review and approval of previously created events to a designated Joomla user. JCal Pro calls this process "moderation".
The events moderation works only for the JCal Pro events that have been previously already created and submitted via your Joomla site frontend.
Once logged in to your site frontend, your JCal Pro event moderator will be able only to:
- View previously created events
- Approve, or give his moderator's thumb up of approval to those events.
Reviewing and publishing the events pre-approved by your JCal Pro moderator still remains up to your Joomla administrator.
Note: JCal Pro events created via JCal Pro backend administrator panel by a Joomla administrator don't need approval. They get the approved and published status by default.
Setting your front-end JCal Pro events moderator is a five-step process:
- Create a Joomla user group for your JCal Pro event moderator(s)
- Create a Joomla access level for your JCal Pro event moderator(s)
- Assign your JCal Pro events moderators user group the Allowed permission for the Moderate action
- Assign the required Joomla user(s) as your JCal Pro events moderator(s)
- Create a front end menu item for your JCal Pro event moderators.
Let's take a look at this process in more detail.
Step #1. Create a user group for moderators
The first step is to create a new Joomla user group specifically dedicated to your JCal Pro moderators.
- In your Joomla control panel, click Users > Groups > Add New Group:
You will see Users: New Group administrative page. Create a new user group:
- Group Title: Enter JCal Pro Events Moderators.
- Group Parent: Select the Registered user group.
- Click Save & Close.
Good job. You now have a special Joomla user group for your JCal Pro events moderators.
Step #2. Create an access level for moderators
In this step, you will ensure that on your Joomla site your JCal Pro events moderators have access only to JCal Pro events moderation and nothing else.
- In your Joomla control panel, go to Users > Access Levels > Add New Access Level:
- Create a new access level:
- Level Title: JCal Pro Events Moderators
- User Groups Having Viewing Access: click "Registered" and click "JCal Pro Events Moderators".
- Click Save & Close.
Excellent. You now have the new Joomla user group and new Joomla access level for your JCal Pro events moderators. You are now ready to assign a required Joomla user(s) as a JCal Pro events moderator.
Step #3. Assign your events moderators required permissions
- Go to Components > JCal Pro to open JCal Pro control panel.
- You will see the JCal Pro: Events default page. In the top-right corner, click the Options button:
- You will see the JCal Pro Configuration page.
- Click the Permissions tab:
- Click the JCal Pro Events Moderators tab:
- Locate the Moderate action in the Action column and select Allowed.
- Click Save & Close.
Well done! You are now ready to delegate front end JCal Pro event creation to your required Joomla user(s).
Step #4. Assign the users as moderators
- Go to Users > Manage:
- You will see the Users administrative page, listing your Joomla users. Click on the name of the user you wish to assign as a JCal Pro events moderator:
- You will be taken to the Users: Edit screen with your selected Joomla user account details. Click the Assigned User Groups tab:
- You should see the checkmark in the Registered checkbox. Click on the JCal Pro Event Moderators checkbox:
- Click Save & Close.
Good job! You now have your dedicated JCal Pro events moderator.
Step #5. Create a front end menu item for moderators
For the front end events moderation, you need to create a front end menu item by the Admin View type.
- Go to Menus > [your-menu] > Add New Menu Item. For my demonstration, I selected the User Menu:
- You will see the Menus: New Item screen. Create a menu item by the JCal Pro > Admin View type. Enter Events Moderation into the Menu Title field and click Select:
- You will see the Menu Item Type modal box. Click JCal Pro > Admin View:
- In the right group of settings, change the Access parameter from the default Public to JCal Pre Events Moderators:
- Log into your site front end as the user to whom you assigned the JCal Pro events moderation permission. Click on the newly created Events Moderation menu item:
How to Test Your Event Moderation
Now is a good time to test our event moderation at work.
- Create a JCal Pro event from your Joomla site's frontend. See this tutorial on step-by-step instructions on how to do this.
- Check this new event in your JCal Pro back-end control panel. You will see that this event is not yet approved nor is it published:
- Visit the front-end of your site and click on the "Event Moderation" menu item you created in Step #5:
- You will see a front end page listing existing JCal Pro events. Events waiting for a moderator's approval will be marked with the icon in the Actions column, as you can see on the image below. Click on this icon:
- You will see "1 Event Approved" message:
- Now, in your Joomla back end, open up your JCal Pro control panel. You should see the newly created event with the Approved status:
- Now is your time as the site's administrator to deal with this newly approved calendar event. You have options to edit it, export it to an iCal formatted file, and publish it.