How to Create Frontend Event Moderators in JCal Pro

How to Assign a Front-End Event Moderator in JCal Pro

JCal Pro is the best calendar extension for Joomla sites.

Over the last weeks, we've talked with several JCal Pro customers who are alllowing users to create events via the frontend of their site. So, we've been writing more documentation to help them, including articles on creating events, registering for events, and giving access to event creation.

This week's tutorial will show you how to allow users to moderate events that are submitted. To create a moderator, you need to follow these five steps:

  1. Create a Joomla user group for your JCal Pro event moderators.
  2. Create a Joomla access level for the moderators.
  3. Set the correct permissions for the moderators.
  4. Choose Joomla users as moderators.
  5. Create a frontend menu link for moderators to use.

Let's take a look at this process in more detail.

Note: This feature works only with events created via your Joomla site frontend. JCal Pro events created via JCal Pro backend control panel don't need approval. They get the approved and published status by default.

Step #1. Create a Joomla 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:

Users > Group > Add New Group

  • You will see Users: New Group administrative page. Create a new user group:
  1. Group Title: Enter JCal Pro Event Moderators.
  2. Group Parent: Select the Registered user group.
  3. Click Save & Close.

Create new Joomla user group for JCal Pro events moderators

Good job. You now have a special Joomla user group for your JCal Pro events moderators. 

Step #2. Create a Joomla access level for the 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:

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. Set the correct permissions for the moderators

  • 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:

Click Options

  • You will see the JCal Pro Configuration page. Click the Permissions tab:

Click JCal Pro Permissions tab

  • Click the JCal Pro Events Moderators tab:

click jcal pro events moderators tab

  • Locate the Moderate action in the Action column and select Allowed.
  • Click Save & Close.

click allowed for the moderate action

Well done! You are now ready to delegate frontend JCal Pro event creation to your required Joomla users.

Step #4. Choose Joomla users as moderators

  • Go to Users > Manage:

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:

06 click on the user name

  • You will be taken to the Users: Edit screen with your selected Joomla user account details. Click the Assigned User Groups tab:

click on the assigned user groups

  • You should see the checkmark in the Registered checkbox. Click on the JCal Pro Event Moderators checkbox:

click on the jcalpro event moderators checkbox

  • Click Save & Close.

Good job! You now have your dedicated JCal Pro events moderator. 

Step #5. Create a frontend menu link

For the frontend events moderation, you need to create a menu item using the Admin View type.

  • Go to Menus > [your-menu] > Add New Menu Item. For my demonstration, I selected the User Menu:

click add new menu item

  • You will see the Menus: New Item screen. Create a menu item using the JCal Pro > Admin View type.
  • Enter Events Moderation into the Menu Title field and click Select:

enter the menu title and click select

  • You will see the Menu Item Type modal box. Click JCal Pro > Admin View:

select the admin view menu type

  • In the right group of settings, change the Access parameter from the default Public to JCal Pre Events Moderators:

set the access to jcalpro events moderators

  • Log into your site frontend as the user to whom you assigned the JCal Pro events moderation permission. Click on the newly created Events Moderation menu item:

click events moderation

Test your event moderation

Now is a good time to test your event moderation.

  • Create a JCal Pro event from your Joomla site 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:

new event as seen at the backend

  • Visit the frontend of your site and click on the "Event Moderation" menu item you created in Step #5:

for testing click events moderation

  • You will see a frontend 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:

click here to approve event

  • You will see "1 Event Approved" message:

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 (the thumb up icon) status:

new event with the approved status

  • Now is your time as the site's owner and superuser to deal with this newly approved calendar event. You have options to edit it, export it to an iCal formatted file, and publish it.

What's Next?

Save $1000's when you sign up to the Everything Club today! You' ll get access to all our extensions, templates, and Joomla training.

About the author

Born from a Ukrainian mother and Russian father, Alex lives in the United Kingdom. Alex is a self-taught Microsoft Certified Professional. He enjoys learning Joomla and helping web site administrators make the most of it.