162 lines
		
	
	
		
			7.3 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			162 lines
		
	
	
		
			7.3 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 | |
| 	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 | |
| <html xmlns="http://www.w3.org/1999/xhtml" lang="en_GB" xml:lang="en_GB">
 | |
| <head>
 | |
| 	<title>Introduction</title>
 | |
| 	<link href="../css/help.css" rel="stylesheet" type="text/css" />
 | |
| </head>
 | |
| <body>
 | |
| <h1>JEM 2.x Help</h1>
 | |
| 
 | |
| <h2><strong>Welcome</strong></h2>
 | |
| 
 | |
| <p>Welcome to the stable version of JEM 2.1 for Joomla 2.5 and 3.3.</p>
 | |
| 
 | |
| <p>
 | |
| 	This software is a fork of Eventlist, one of the most popular non-commercial Event Management components for Joomla. <br/>
 | |
| 	This first public release of JEM combines the functionality of Eventlist 1.0.1, 1.0.2 and 1.1,
 | |
| 	together with many code improvements and tweaks and hacks that have been contributed by the community over the last years.
 | |
| </p>
 | |
| 
 | |
| <p>
 | |
| 	With JEM 2.1 you get a version supporting both Joomla 2.5 (2.5.24 or newer) and Joomla 3.3 (3.3.3 or newer).
 | |
| 	Also Joomla 3.2.7 or newer is supported for sites where Joomla 3.3 can't be used caused by an old PHP version.
 | |
| 	The main difference between JEM 2.0 and 2.1 series is additional support for Joomla 3.
 | |
| 	So you can simply update from JEM 2.0.x to 2.1.x. We suggest to do so before upgrading to Joomla 3.3.
 | |
| </p>
 | |
| 
 | |
| <p>Together with the JEM component, the following modules and plugins have been installed:</p>
 | |
| 
 | |
| <ul>
 | |
| 	<li>JEM Module, (upcoming events basic module)</li>
 | |
| 	<li>JEM Wide Module, (upcoming events Wide module)</li>
 | |
| 	<li>Calendar Module, for date navigation</li>
 | |
| 	<li>Teaser Module, to display upcoming events</li>
 | |
| 	<li>Search Plugin</li>
 | |
| 	<li>Finder Plugin (smart search)</li>
 | |
| 	<li>Mailer Plugin, to make the settings on which events JEM should send emails</li>
 | |
| 	<li>Comments Plugin, integration with JomComments, JComments, JXtended Comments</li>
 | |
| </ul>
 | |
| 
 | |
| <p>
 | |
| 	If you want to use any of these modules and plugins,
 | |
| 	please do not forget to publish them in the module manager and the plugin manager.
 | |
| </p>
 | |
| 
 | |
| <p>We hope you like this new version of JEM for Joomla 2.5 and 3.3!</p>
 | |
| 
 | |
| <p>The JEM Development Team, December 2014</p>
 | |
| 
 | |
| <div class="box">
 | |
| 	<p class="attentionheader">Attention</p>
 | |
| 	<p class="attention">Read this introduction carefully! If you still have questions click on the Help button and read the screens. If you need additional help and information have a look at the "Get Help" screen on top of the Help center.</p>
 | |
| </div>
 | |
| 
 | |
| 
 | |
| <h2><strong>Introduction</strong></h2>
 | |
| 
 | |
| <p>
 | |
| 	JEM is an Event Management Component for Joomla.
 | |
| 	It's not a calendar but an easy way to manage and present your events for your group, company or community.
 | |
| 	JEM offers a lot of features and possibilities which make your work easier, like the Venue database, Event recurrence,
 | |
| 	Venue geotagging and much more.
 | |
| 	But also for your site visitors JEM has some additional features to offer,
 | |
| 	like a simple registration system, map service links, or the submission/edit of events and venues from the site Frontend.
 | |
| </p>
 | |
| 
 | |
| 
 | |
| <h2><strong>Quickstart guide</strong></h2>
 | |
| 
 | |
| <p>After the successful installation of JEM you need to take at least 3 steps.</p>
 | |
| 
 | |
| 
 | |
| <p><strong>The first step</strong> is to configure the settings you need in the JEM configuration. Set the format of the date and
 | |
| 	time, enable image thumbnail creation and set the layout of the table columns. <br/>
 | |
| 	Optionally you can integrate the <a href="http://www.joomlapolis.com" target="_blank">community builder</a> enhanced
 | |
| 	user profile component in the settings. Most of the settings are self explanatory. If not, move your mouse pointer
 | |
| 	over the text to get more detailed information or click on the help icon in the toolbar.</p>
 | |
| 
 | |
| 
 | |
| <p><strong>The second step</strong> is to create the categories. Every event you create must be assigned to a category. For example,
 | |
| 	if you have a music site you could use Rock, Rap, Dance, Electronic, etc.
 | |
| 	For each category you can set access permission levels. All events assigned to this category will only be visible
 | |
| 	for the group you have given access to.</p>
 | |
| 
 | |
| <p><strong>The third step</strong> is to create the menu item(s) in the Joomla! menu manager. JEM offers many different menu views:</p>
 | |
| 
 | |
| <ul>
 | |
| 	<li>A Calendar View</li>
 | |
| 	<li>A Category Listing</li>
 | |
| 	<li>A Category Listing (detailed)</li>
 | |
| 	<li>A Category Calendar</li>
 | |
| 	<li>A Single Category Listing</li>
 | |
| 	<li>A Listing of the Current Day</li>
 | |
| 	<li>An Event Submission Form</li>
 | |
| 	<li>A Venue Submission Form</li>
 | |
| 	<li>A Single Event View</li>
 | |
| 	<li>A Simple List of Events</li>
 | |
| 	<li>My Attendances</li>
 | |
| 	<li>My Events</li>
 | |
| 	<li>My Venues</li>
 | |
| 	<li>A Search Form</li>
 | |
| 	<li>A Venue Calendar</li>
 | |
| 	<li>A Single Venue</li>
 | |
| 	<li>A Venues Listing</li>
 | |
| 	<li>A Week Calendar</li>
 | |
| </ul>
 | |
| 
 | |
| <p>
 | |
| 	If you have taken these steps you are ready to input your events.
 | |
| 	If you want to assign your events to venues you first have to create the venue information.
 | |
| </p>
 | |
| 
 | |
| <h2><strong>ACL - Access Control List</strong></h2>
 | |
| <p>	Some special attention is required for ACL. If you want to use it, you need to know that Joomla ACL is partially integrated in version 2.x of JEM.
 | |
| 	At this moment ACL works on Categories and Events, not yet on Venues.
 | |
| 
 | |
| <p>	Viewing rights are set in Joomla under:
 | |
| 	<strong>Users</strong> → <strong>Access Levels</strong> → <strong>Viewing Access Levels</strong></p>
 | |
| 
 | |
| <p>	Edit rights are set in JEM under:
 | |
| 	<strong>Control Panel</strong> → <strong>Options (icon)</strong> → <strong>Permissions</strong></p>
 | |
| 	Here you can set global permissions per user group.
 | |
| 	So for example if you only want publisher to create/edit stuff you can:
 | |
| <ul>
 | |
| 	<li>create user</li>
 | |
| 	<li>assign that user only to the group "publisher"</li>
 | |
| 	<li>create access-view level in the back called "publisher"</li>
 | |
| 	<li>click the config button (jem main view), set rights for publisher</li>
 | |
| </ul>
 | |
| <p>	Now you can create a menu-link to submit-event and set access to publisher. But when viewing the eventslist the
 | |
| 	user will see the submitbutton and when viewing an event he can edit it. <br/>
 | |
| 	Be aware that someone with the access/edit rights will see all the categories!
 | |
| 
 | |
| 	Further restricted access is organised via JEM Groups. Here you can specify an unlimited number of groups that contain users.
 | |
| 	If a group is assigned to a Category only the specified users in the group have write access to that category.</p>
 | |
| 
 | |
| <p>	In Events there are 2 ACL settings: The first one is an indirect one. Via the category (or categories) to which an event belongs,
 | |
| 	edit access can be restricted to the users in the group that is linked to the Category. Also the read access level of cateories is respected.
 | |
| 	The second ACL setting is the read access. This is derived from the category/ies access level but can also be set using Access field of the event.
 | |
| 
 | |
| 	Please note that user needs correct view access level to see and edit events. Edit permission is not enough.
 | |
| </p>
 | |
| 
 | |
| <h2></h2>
 | |
| <p><strong>If you like JEM and find it useful, please consider a donation to cover for the hosting expenses of the community.</strong></p>
 | |
| 
 | |
| 
 | |
| <h2>Notes</h2>
 | |
| 
 | |
| <ul>
 | |
| 	<li>JEM is released under the terms and conditions of the <a
 | |
| 		href="http://www.gnu.org/licenses/gpl-2.0.html" target="_blank"><strong>GNU GPL license</strong></a></li>
 | |
| 	<li>This software is produced by our community of volunteers at our best effort, and distributed with the hope to be useful but
 | |
| 		<strong>WITHOUT ANY WARRANTY!</strong> You use JEM at your <strong>OWN</strong> risk</li>
 | |
| </ul>
 | |
| 
 | |
| <div class="close">
 | |
| 	<a href="#" onclick="javascript:window.close();">Close window</a>
 | |
| </div>
 | |
| </body>
 | |
| </html>
 |