JEM 4.x+ Hilfe

Willkommen

Willkommen zur stabilen Version von JEM 4 für Joomla 4 und Joomla 5.
JEM 4 läuft unter Joomla 4.x und Joomla 5.x und php 8.

Für Seiten mit Joomla 3.x bitte JEM 2.3.5 oder 2.3.6 verwenden. Bitte beachten, dass wir nicht jede JEM Ausgabe mit allen alten Joomla Versionen intensiv testen können. Wir fokussieren uns auf die aktuellen Joomla Versionen.

Kurze Geschichte

Diese Software ist ein Fork von Eventlist, einer der populärsten nicht-kommerziellen Event Management Komponente für Joomla.
Seither wurde JEM kontinuierlich weiter entwickelt und kombiniert heute die Funktionalität von Eventlist mit zahlreichen Verbesserungen und über Jahre hinweg durch die Community diskutierten Erweiterungen.

Zusammen mit der JEM Komponente wurden die folgenden Module und Plugins im JEM Paket installiert:

• JEM Basis Modul,
• JEM Breites Modul,
• Kalender Modul, für Datumsnavigation, womöglich mit Ajax
• Teaser Modul, zur Anzeige kommender Events
• Banner Modul, eine Variante zur Anzeige kommender Events
• Jubiläums Modul zur Anzeige vergangener Events, die heute ein Jubiläum haben (wie "Heute vor einem Jahr am 20. April)
• Such Plugin
• Finder Plugin (Smart Search)
• List Events Plugin (um JEM Events in andere Inhalte wie Artikel, Modules usw. einzufügen)
• Mailer Plugin, zum Einstellen der Gelegenheiten, bei denen Emails versandt werden sollens
• Comments Plugin, Integration mit Kommentarprogrammen wie JComments
• Content Plugin
• JEM Quickicon (um JEM schnell vom Dashboard aus zu starten
• Als separate Dateien stehen zum Download und Installation bereit:
  CB_Myattending plugin - Zeigt in Community Builder Profil Events, bei denen der Benutzer eine Teilnahmemeldung gemacht hat. (Muss mit CB plugin Manager installiert werden)
  CB_Myevents plugin - Zeigt in Community Builder Profil vom Benutzer erstellte Events. (Muss mit CB plugin Manager installiert werden)
  ...und viele Sprachdateien - mit grossem Dank an alle Übersetzende in aller Welt

Wir hoffen, Sie lieben diese neue Version von JEM für Joomla 4.x+ !
Das JEM Entwicklungs Team, Juli 2023

Einführung

JEM ist eine Event Management Komponente für Joomla. Es ist kein Kalender, sondern ein einfacher Weg Veranstaltungen und Events von ihrer Gruppe, Gesellschaft oder Gemeinschaft zu verwalten und zu präsentieren. JEM bietet viele Möglichkeiten zur Arbeitserleichterung: Eventsort-Listen, Events-Wiederholungen, Eventsorts-Karten und viel mehr. Aber auch die Besucher finden zusätzliche Möglichkeiten: ein einfaches Anmeldesystem zu Events, Links zu Karten, Einreichen von Events und Lokalitäten vom Frontend aus.

Schnellstart

Nach einer erfolgreichen Installation von JEM braucht es wenigstens die folgenden 3 Schritte:

Der erste Schritt ist das Konfigurieren der gewünschten Einstellungen in der JEM Konfiguration. Einstellen von Datums- und Zeitformat, Aktivieren der Bild-Thumbnail-Erstellung und das Setzen des Tabellenlayouts.
Optional kann das mit Community Builder erstellte Benutzerprofil integriert werden. Die meisten Einstellungen erklären sich selbst. Wo nicht, bewege die Maus über den Text, um detailliertere Infos zu erhalten oder klicke auf das Hilfe Icon in der Werkzeugleiste.

Der zweite Schritt ist die Erstellung von Kategorien. Jeder erstellte Event muss zu einer Kategorie gehören. Z.B. bei einer Musikseite kann man Rock, Rap, Dance, Electronic usw. benutzen. Es kann aber auch z.B. nach verschiedenen Zielgruppen kategorisiert werden. Für jede Gruppe kann man einen Zugriffslevel setzen. Alle Events dieser Kategorie sind dann nur sichtbar für die berechtigte Gruppe.

Der dritte Schritt ist das Erstellen von Menüpunkten im Joomla! Menümanager. JEM bietet viele verschiedene Menüansichten an:

• Kalenderanzeige
• Kategorienliste
• Kategorie mit ihren Veranstaltungen
• Kalender nur einer Kategorie
• Tagesansicht
• Veranstaltung einreichen
• Veranstaltungslokalität einreichen
• Ansicht einer Veranstaltung
• Einfache Events-Liste (mit vielen Variationsmöglichkeiten)
• Meine Teilnahme-Rückmeldungen (An-/Abmeldungen)
• Meine Events
• Meine Event-Lokalitäten
• Formular zur Suche von Events
• Kalender nur einer Eventlokalität
• Ansicht einer Eventlokalität
• Liste aller Eventlokalitäten
• Wochenkalender
  
  Nach diesen Schritten können deine Events eingegeben werden. Es empfiehlt sich allerdings, zuerst auch die Eventlokalität zu erstellen. So können die Events direkt zugeteilt werden. Es ist aber auch möglich, Events noch keinem Ort zuzuteilen.

ACL - Access Control Liste

Spezielle Beachtung sollte man der ACL-Zugriffsregelung schenken. Wenn Sie sie verwenden wollen, müssen Sie wissen, dass das Joomla ACL teilweise in JEM 2.0 intergriert ist. Aktuell funktioniert ACL mit Kategorien und Veranstaltungen, noch nicht mit Veranstaltungsorten.

Die Rechte zur Ansicht sind in Joomla gesetzt unter :Benutzer → Zugriffsebenen → Zugriffsebenen

Editierrechte sind in JEM gesetzt unter: Bedienungsübersicht → Einstellungen (icon) → Benutzerrechte

Hier können Globale Bewilligungnen für Benutzergruppen erstellt werden. Z.B. Wenn nur "publisher" neu erstellen/ bearbeiten dürfen, kann man:

• Benutzer erstellen
• Benutzer nur zur Gruppe "publisher" zuordnen
• einen Access-view Level "publisher" im Backend erstellen
• Einstellungen im JEM Hauptmenü wählen und Rechte für "publisher"

Jetzt können sie einen Menülink erstellen "Veranstaltung einreichen" und diesem Zugriff für "publisher" geben. Wenn die Eventsliste angeschaut wird, kann der entsprechende Benutzer ein Icon sehen zur Einreichung von Events und in der Eventansicht kann er ein Bearbeitungs-Icon finden.
Seien Sie sich bewussst, dass jemand mit Bearbeitungsrechten alle Kategorien sehen kann! Erweiterte Zugriffsrechte- und -Einschränkungen werden via JEM-Gruppen organisiert. Dort kann man eine unbegrenzte Zahl von (Arbeits-)Gruppen mit ausgewählten Benutzern bilden. Wenn eine Gruppe zu einer Kategorie zugeordnet ist, können nur die ausgewählten Benutzer der Gruppe auf diese Kategorie zugreifen.

Bei den Veranstaltungen gibt es 2 Einstellungen: Zuerst eine indirekte. Via Kategorie (oder Kategorien) zu denen eine Veranstaltung gehört kann Bearbeitungszugriff auf die Benutzer der zugeordneten Arbeitsgruppe beschränkt werden. Zum zweiten gehört die ACL-Einstellung für den Lese-Zugriff durch die Wahl der Joomla Benutzergruppe im Event

Wenn Sie JEM mögen und Sie es Ihren Zwecken dient, überlegen Sie sich doch eine Spende zur Deckung der Hosting-Auslagen der Community

Beachte

• JEM ist veröffentlicht unter den "terms and conditions of the GNU GPL license"
• Diese Software wurde erstellt durch unsere community von Freiwilligen mit unseren besten Wissen und Können, und wird verteilt in der Hoffnung, dass es brauchbar ist. Jedoch OHNE JEDE GARANTIE! Sie benutzen JEM auf ihr EIGENES RISIKO.

JEM 4.x Hilfe

Willkommen

Willkommen zur stabilen Version von JEM 4 für Joomla 4 und 5.
JEM 4 läuft unter Joomla 4 und 5 sowie PHP 8.

Wenn Sie noch Joomla 3.x verwenden, nutzen Sie bitte JEM 2.3.6, bevor Sie auf Joomla 5 und JEM 4.x aktualisieren. Bitte beachten Sie, dass wir nicht jede JEM-Version umfassend mit älteren Joomla-Versionen testen können. Wir konzentrieren uns auf die neuesten Joomla-Versionen.

Short History

JEM is a fork of Eventlist, one of the most popular non-commercial Event Management components for Joomla.
Since then JEM has continuously been evolved and combines today the functionality of Eventlist together with many code improvements and tweaks and hacks that have been contributed by the community over the last years.

Together with the JEM component, the following modules and plugins have been installed by the JEM package:

• Basic Module – includes several layouts with different styles.
• Wide Module – horizontal style.
• Calendar Module – for date navigation, using Ajax if possible. Several layouts.
• Teaser Module – to display upcoming events.
• Banner Module – another module to display upcoming events.
• Jubilee Module – to display past events that occurred on today’s date, now considered a jubilee (e.g. “One year ago on April 20…”).
• Map Module – to display venues with upcoming events over the next days, based on a time filter.
• Search Plugin (Joomla 4 only).
• Finder Plugin (Smart Search).
• List Events Plugin – to integrate JEM events into other content such as articles, modules, etc.
• Mailer Plugin – to define which JEM changes should trigger email notifications.
• Content Plugin – to display event lists within articles or other content.

As separate install files you could additionally download and install:

• JEM Quickicon Plugin (to launch JEM in one click from the backend dashboard)
• CB_Myattending plugin - Shows events where the user is attending in a Community Builder profile. Needs to be installed with special CB plugin manager inside of Community Builder (must be installed using CB's installer)
• CB_Myevents plugin - Shows events that were created by the user in a Community builder profile. Needs to be installed with special CB plugin manager inside of Community Builder (must be installed using CB's installer)
• ...and a lot of languages - with many thanks to all the translators around the world!

The Comments Plugin, for integration with JComments is not needed anymore, since JComments now works without plugin

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.

We hope you like this new version of JEM for Joomla 4!

The JEM Development Team, July 2023

Introduction

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.

Quickstart guide

After the successful installation of JEM you need to take at least 3 steps.

The first step 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.
Optionally you can integrate the community builder 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.

The second step 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.

The third step is to create the menu item(s) in the Joomla! menu manager. JEM offers many different menu views:

• A Calendar View
• A Category Listing (optonally detailed)
• A Category Calendar
• A Single Category Listing
• A Listing of the Current Day
• An Event Submission Form
• A Venue Submission Form
• A Single Event View
• A Simple List of Events
• A List of Event Registrations
• My Attendances
• My Events
• My Venues
• A Search Form
• A Venue Calendar
• A Single Venue
• A Venues Listing
• A Week Calendar

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.

ACL - Access Control List

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.

Viewing rights are set in Joomla under: Users → Access Levels → Viewing Access Levels

Edit rights are set in JEM under: Control Panel → Options (icon) → Permissions

Here you can set global permissions per user group. So for example if you only want publisher to create/edit stuff you can:

• create user
• assign that user only to the group "publisher"
• create access-view level in the back called "publisher"
• click the config button (jem main view), set rights for publisher

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. 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 also the specified users in the group have write access to that category. With this you could allow registered users not havong general author permission to create events in a specific category.

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 JEM 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 a user needs view access level of event AND one of the categories event is assigned to to see and edit event. Edit permission is not enough.

Please note that general permissions for Joomla default groups like Author, Editor, Publisher will automatically give those users such permissions on JEM items too. If you need to give users different permissions for e.g. events or articles you should create new user groups and give permissions for the relevant component, e.g. different groups Event Authors and Article Authors. Denying permissions may give surprising results and is not recommended.

If you like JEM and find it useful, please consider a donation to cover for the hosting expenses of the community.

Notes

• JEM is released under the terms and conditions of the GNU GPL license
• This software is produced by our community of volunteers at our best effort, and distributed with the hope to be useful but WITHOUT ANY WARRANTY! You use JEM at your OWN risk