Dokumentation zur Komponente „Kurse“

Einleitung

• Kursverwaltung: Erstellen und organisieren Sie eine unbegrenzte Anzahl von Kursen mit Beschreibungen, Bildern und Preisen
• Kategoriesystem: Ordnen Sie Kurse in logische Kategorien ein
• E-Commerce-Integration: Akzeptieren Sie Zahlungen über PayPal (Sandbox- und Live-Modus)
• Bewertungssystem: Ermöglichen Sie Kunden, Kurse zu bewerten und zu rezensieren
• Modul-Anzeige: Präsentieren Sie Kurse auf Ihrer gesamten Website mithilfe anpassbarer Modulvorlagen
• Kaufverfolgung: Behalten Sie den Überblick über alle Kurskäufe und Transaktionen
• Dozentenprofile: Fügen Sie jedem Kurs ein Bild, einen Namen und eine Beschreibung des Dozenten hinzu
• Kurskennzahlen: Zeigen Sie die Anzahl der Lektionen und die Teilnehmerzahlen an
• Flexible Anzeigeoptionen: 21 verschiedene Darstellungsstile für die Kurspräsentation

Installation

Systemanforderungen

• Joomla 4 oder höher
• PHP 7.0 oder höher
• MySQL 5.5+ oder PostgreSQL 9.5+

Installationsschritte

1. Laden Sie die Komponente herunter
   • Laden Sie das Mx Courses-Komponentenpaket herunter (ZIP-Datei mit Komponente, Modul und Plugin)
2. Installieren Sie die Komponente über Joomla
   • Melden Sie sich bei Ihrem Joomla-Administratorbereich an
   • Navigieren Sie zu „System“ → „Installieren, Aktualisieren, Erweiterungen“
   • Klicken Sie auf die Registerkarte „Paketdatei hochladen“
   • Wählen Sie die heruntergeladene ZIP-Datei von „Mx Courses“ aus
   • Klicken Sie auf „Hochladen & Installieren“
3. Überprüfen Sie die Installation
   • Navigieren Sie im Admin-Menü zu „Komponenten“ → „Mx Courses“
   • Sie sollten nun die Verwaltungsoberfläche für Kurse sehen
4. Datenbanktabellen
   • Der Installationsprozess legt automatisch die erforderlichen Datenbanktabellen an:
     • jos_mxcourses_items (Kurselemente)
     • jos_mxcourses_purchases (Kaufdatensätze)

Ersteinrichtung und Konfiguration

Aufrufen der Komponenteneinstellungen

1. Gehen Sie im Administrator-Menü zu „Komponenten“ → „Mx-Kurse“
2. Klicken Sie auf die Schaltfläche „Optionen“ in der Symbolleiste (oben rechts)

Konfigurationsbereiche

Grundeinstellungen

Einstellungen für Medien und Miniaturansichten

Konfigurieren Sie, wie Kurs-Miniaturansichten generiert und angezeigt werden:

Kauf- und Bewertungsoptionen

E-Commerce- und Bewertungsfunktionen aktivieren:

Berechtigungen

Legen Sie Benutzerzugriffsebenen für die Verwaltung von Kursen und die Anzeige von Käufen fest:

• Kernberechtigungen für die Verwaltung
• Berechtigungen für verschiedene Benutzergruppen anzeigen

Verwaltung von Kategorien

Kategorien helfen dabei, Kurse logisch zu organisieren und die Navigation zu verbessern.

Eine Kategorie erstellen

1. Navigieren Sie zu „Komponenten“ → „Kategorien“
2. Wählen Sie „Mx Courses“ aus dem Dropdown-Menü „Erweiterung“ aus (falls erforderlich)
3. Klicken Sie auf „Neu“
4. Geben Sie die Details zur Kategorie ein:
   • Titel: Name der Kategorie (z. B. „Webentwicklung“)
   • Alias: URL-freundlicher Name
   • Beschreibung: Beschreibung der Kategorie (optional)

Kurse Kategorien zuordnen

1. Kurs bearbeiten
2. Wählen Sie im Dropdown-Menü „Kategorie“ die entsprechende Kategorie aus
3. Speichern Sie den Kurs

Organisieren der Kategoriehierarchie

Kategorien unterstützen eine Eltern-Kind-Struktur:

1. Erstellen Sie eine übergeordnete Kategorie (z. B. „Programmierung“)
2. Erstellen Sie Unterkategorien (z. B. „Webentwicklung“, „Desktop-Anwendungen“)
3. Wählen Sie beim Erstellen von Unterkategorien im Feld „Übergeordnete Kategorie“ die übergeordnete Kategorie aus

Verwaltung von Kursen (Elementen)

Einen neuen Kurs erstellen

1. Navigieren Sie zu „Komponenten“ → „Mx-Kurse“ → „Elemente“
2. Klicken Sie auf die Schaltfläche „Neu“
3. Geben Sie die Kursdetails ein:

Pflichtfelder

Medienfelder

Preise & Details

Anzeigeoptionen

Kurs bearbeiten

1. Navigieren Sie zu „Komponenten“ → „Mx-Kurse“ → „Elemente“
2. Klicken Sie auf den Kurstitel, um ihn zu bearbeiten
3. Passen Sie die Details nach Bedarf an
4. Klicken Sie auf „Speichern“ oder „Speichern & Schließen“

Kurse veröffentlichen/deaktivieren

Einzelner Kurs

1. Klicken Sie auf den Kurs, um ihn zu bearbeiten
2. Setzen Sie den Status auf „Veröffentlicht“ (grünes Häkchen) oder „Nicht veröffentlicht“
3. Klicken Sie auf „Speichern“

Massenaktionen

1. Wählen Sie in der Listenansicht „Elemente“ einen oder mehrere Kurse über die Kontrollkästchen aus
2. Klicken Sie auf das Dropdown-Menü „Status“ und wählen Sie:
   • Veröffentlichen – Sichtbar machen
   • Veröffentlichung aufheben – Vor der Öffentlichkeit verbergen
   • Archivieren – In das Archiv verschieben
   • Papierkorb – Löschen (kann wiederhergestellt werden)

Kurse löschen

Vorläufiges Löschen (Papierkorb)

1. Wählen Sie den/die zu löschenden Kurs(e) aus
2. Klicken Sie auf die Schaltfläche „Papierkorb“ oder wählen Sie die Option aus dem Dropdown-Menü „Status“ aus
3. Die Kurse werden in den Papierkorb verschoben, können aber wiederhergestellt werden

Endgültiges Löschen

1. Navigieren Sie zu den Kursen im Status „Papierkorb“
2. Wählen Sie den/die Kurs(e) aus
3. Klicken Sie auf die Schaltfläche „Löschen“
4. Löschung bestätigen

Zahlungs- und Kaufoptionen konfigurieren

PayPal einrichten

Sandbox-Modus (Test)

1. Gehen Sie zu „Komponenten“ → „Mx Courses“ → „Optionen“
2. Klicken Sie auf die Registerkarte „Kauf & Bewertung“
3. Aktivieren Sie „Kaufen aktivieren“
4. Stellen Sie den Zahlungsmodus auf „Sandbox“ ein
5. Geben Sie Ihre Sandbox-PayPal-E-Mail-Adresse ein
6. Legen Sie die Währung fest (in der Regel USD für Testzwecke)
7. Klicken Sie auf „Speichern“

So erhalten Sie die Sandbox-Zugangsdaten:

• Besuchen Sie die PayPal Developer Sandbox
• Erstellen Sie ein Testkonto für Unternehmen
• Verwenden Sie die in der Sandbox angegebene geschäftliche E-Mail-Adresse

Live-Modus (Produktion)

1. Gehen Sie zu „Komponenten“ → „Mx Courses“ → „Optionen“
2. Klicken Sie auf die Registerkarte „Kauf & Bewertung“
3. Stellen Sie die Zahlungsart auf „Live“ ein
4. Geben Sie Ihre PayPal-Geschäfts-E-Mail-Adresse ein (verifiziertes PayPal-Konto)
5. Stellen Sie die Währung auf die gewünschte Währung ein
6. Klicken Sie auf „Speichern“

Wichtig: Wechseln Sie erst nach gründlichen Tests im Sandbox-Modus in den Live-Modus.

Käufe verwalten

Verfolgen Sie alle Kundenkäufe:

1. Navigieren Sie zu „Komponenten“ → „Mx Courses“ → „Käufe“
2. Zeigen Sie die Liste aller Käufe an:
   • Kundenname
   • Kursbezeichnung
   • Kaufdatum
   • Bezahlter Betrag
   • Zahlungsstatus

Erläuterung des Kaufstatus

• Ausstehend: Zahlung eingegangen, aber noch nicht bestätigt
• Abgeschlossen: Zahlung bestätigt, Kunde hat Zugriff
• Fehlgeschlagen: Die Zahlungstransaktion ist fehlgeschlagen
• Rückerstattet: Die Zahlung wurde zurückerstattet

Anzeigeeinstellungen des Moduls

Das Modul „Mx Courses“ zeigt Kurse auf Ihrer gesamten Website an.

Installation des Moduls

1. Das Modul „mod_mx_course“ wird mit der Komponente installiert
2. Navigieren Sie im Admin-Panel zu „Erweiterungen“ → „Module“
3. Klicken Sie auf „Neu“, um eine neue Modulinstanz zu erstellen

Modulkonfiguration

Grundeinstellungen

Modulparameter

Verfügbare Anzeigestile

Wählen Sie aus 21 verschiedenen Modul-Layouts:

Probieren Sie verschiedene Stile aus, um das beste Erscheinungsbild für Ihre Website zu finden.

Modul den Menüseiten zuweisen

So zeigen Sie das Modul nur auf bestimmten Seiten an:

1. Bearbeiten Sie das Modul
2. Klicken Sie auf die Registerkarte „Menüzuordnung“
3. Wählen Sie:
   • Auf allen Seiten: Überall anzeigen
   • Auf Seiten, auf denen: Nur auf ausgewählten Seiten anzeigen
   • Auf Seiten, auf denen NICHT: Auf ausgewählten Seiten ausblenden

Frontend-Funktionen

Kundenansicht

Kursübersichtsseite

Kunden sehen:

• Kurstitel und Miniaturbild
• Kurzbeschreibung (Einführungstext)
• Name, Beschreibung und Profilbild des Kursleiters
• Anzahl der Lektionen und Teilnehmerzahlen
• Preis (falls festgelegt)
• Bewertungen und Rezensionen (falls aktiviert)
• Schaltfläche „Weiterlesen“ oder „Jetzt kaufen“

Kursdetailseite

Bei der Ansicht eines vollständigen Kurses:

• Vollständige Kursbeschreibung
• Kursbild in voller Größe
• Detaillierte Informationen
• Preis und Schaltfläche „Kurs kaufen“ (sofern aktiviert)
• Durchschnittliche Bewertung und Kundenrezensionen

Einen Kurs kaufen

Für kostenpflichtige Kurse:

1. Klicken Sie auf die Schaltfläche „Kurs kaufen“
2. Bestätigen Sie die Kursdetails
3. Weiterleitung zur PayPal-Zahlungsseite
4. Schließen Sie die PayPal-Zahlung ab
5. Zurück zur Website mit Kaufbestätigung
6. Greifen Sie auf die Kursmaterialien zu (falls zutreffend)

Bei kostenlosen Kursen:

1. Klicken Sie auf die Schaltfläche „Anmelden“ (sofern aktiviert)
2. Sofortige Anmeldung als registrierter Nutzer

Bewertungen und Rezensionen hinterlassen

Wenn die Bewertung aktiviert ist:

1. Scrollen Sie auf der Kursdetailseite zum Bewertungsbereich
2. Klicken Sie auf die gewünschte Sternebewertung (1–5 Sterne)
3. Fügen Sie optional einen Kommentar hinzu
4. Bewertung absenden

Berechtigungsregeln:

• Alle: Jeder Besucher kann eine Bewertung abgeben (nur für angemeldete Benutzer)
• Nur Käufer: Nur Kunden, die den Kurs gekauft haben, können bewerten

Suchintegration

Wenn die Joomla-Suche aktiviert ist:

• Erscheinen die Kurse in den Suchergebnissen der Website
• Die Suche umfasst Titel, Beschreibung und Einleitungstext
• Die Komponente verfügt über ein Finder-Plugin für die erweiterte Suche

Fehlerbehebung

Häufige Probleme und Lösungen

Kurse werden auf der Website nicht angezeigt

Problem: Kurse sind konfiguriert, aber im Modul nicht sichtbar

Lösungen:

• Überprüfen Sie, ob der Kursstatus auf „Veröffentlicht“ gesetzt ist
• Stellen Sie sicher, dass das Modul veröffentlicht ist
• Überprüfen Sie, ob die Menüzuordnung des Moduls die aktuelle Seite enthält
• Leeren Sie den Joomla-Cache (System → Cache → Alle löschen)
• Überprüfen Sie die Kategorizierung, falls nach Kategorien gefiltert wird

Bilder werden nicht angezeigt

Problem: Kursbilder werden fehlerhaft oder gar nicht angezeigt

Lösungen:

• Überprüfen Sie, ob die Bilddatei auf dem Server vorhanden ist
• Überprüfen Sie den Bildpfad in der Datenbank
• Miniaturansichten zurücksetzen (Komponenten → Mx Courses → Optionen → Medien → Miniaturansichten zurücksetzen)
• Überprüfen Sie die Berechtigungen der Bilddatei (sie sollte lesbar sein)
• Versuchen Sie, das Bild erneut hochzuladen

PayPal-Zahlungen funktionieren nicht

Problem: Die Schaltfläche „Kurs kaufen“ funktioniert nicht oder die Zahlung schlägt fehl

Lösungen:

• Überprüfen Sie, ob die Option „Kaufen“ aktiviert ist
• Überprüfen Sie, ob die PayPal-E-Mail-Adresse korrekt ist
• Testen Sie im Sandbox-Modus, bevor Sie live gehen
• Überprüfen Sie die IPN-Einstellungen (Instant Payment Notification) in PayPal
• Überprüfen Sie die Server-Fehlerprotokolle auf PayPal-IPN-Fehler
• Stellen Sie sicher, dass im Live-Modus ein SSL-Zertifikat vorhanden ist

Miniaturansichten werden nicht generiert

Problem: Benutzerdefinierte Miniaturansichten werden nicht angezeigt oder sehen falsch aus

Lösungen:

• Gehen Sie zu „Optionen“ → Registerkarte „Medien“
• Klicken Sie auf die Schaltfläche „Miniaturansichten zurücksetzen“
• Warten Sie, bis der Vorgang abgeschlossen ist
• Überprüfen Sie die Einstellung „Miniaturbildstil“ in jedem Kurs
• Stellen Sie sicher, dass das Bild die Mindestanforderungen an die Größe erfüllt

Datenbankfehler bei der Installation

Problem: Die Installation schlägt mit einem Datenbankfehler fehl

Lösungen:

• Stellen Sie sicher, dass der Datenbankbenutzer über die Berechtigungen „CREATE/ALTER TABLE“ verfügt
• Überprüfen Sie die Kompatibilität der MySQL-/PostgreSQL-Versionen
• Stellen Sie sicher, dass das Datenbankpräfix nicht mit vorhandenen Tabellen in Konflikt steht
• Versuchen Sie, die Komponente zu deinstallieren und neu zu installieren
• Überprüfen Sie die Joomla-Systemprotokolle auf spezifische Fehler

FAQ

Allgemeine Fragen

F: Kann ich unterschiedliche Preise für verschiedene Benutzergruppen festlegen?
A: Die Komponente unterstützt einen Preis pro Kurs. Für erweiterte Preisgestaltungsmöglichkeiten sollten Sie die Verwendung zusätzlicher Joomla-Commerce-Plugins in Betracht ziehen.

F: Welche Zahlungsmethoden werden unterstützt?
A: Derzeit ist PayPal die primäre Zahlungsmethode. Zusätzliche Zahlungsgateways erfordern eine individuelle Entwicklung.

F: Kann ich Kursrabatte oder Gutscheine anbieten?
A: Die Basiskomponente enthält keine Rabattfunktion. Erweiterungen von Drittanbietern bieten diese Funktion möglicherweise an.

Technische Fragen

F: Unterstützt die Komponente mehrere Sprachen?
A: Ja, sie ist vollständig mehrsprachig kompatibel. Erstellen Sie Kurse in verschiedenen Sprachen mithilfe des Felds „Sprache“.

F: Kann ich Kursdaten exportieren?
A: Der Zugriff auf die Exportfunktion erfolgt über die Komponenten-Tools von Joomla oder direkt über die Datenbank (MySQL/PostgreSQL).

F: Gibt es eine API zur Integration mit externen Systemen?
A: Die Komponente nutzt die Standard-MVC-Architektur von Joomla. Benutzerdefinierte API-Endpunkte erfordern eine individuelle Entwicklung.

Fragen zur Anpassung

F: Kann ich die Anzeigevorlagen des Moduls anpassen?
A: Ja, die Modulvorlagen befinden sich in /modules/mod_mx_course/tmpl/. Bearbeiten Sie die Stilvorlagen, um die Layouts anzupassen.

F: Wie füge ich benutzerdefinierte Felder zu Kursen hinzu?
A: Ändern Sie die XML-Formular-Definitionsdateien in /admin/models/forms/item.xml.

F: Kann ich den Kaufprozess anpassen?
A: Ja, bearbeiten Sie den Site-Controller und den IPN-Handler in /site/controller.php.

Fragen zur Leistung

F: Verlangsamt diese Komponente meine Website?
A: Nein, sie ist auf Leistung optimiert. Verwenden Sie das Joomla-Caching, um optimale Ergebnisse zu erzielen.

F: Wie viele Kurse kann ich erstellen?
A: Unbegrenzt. Die Leistung hängt von den Serverressourcen und der Caching-Strategie ab.

Support & Ressourcen

• Support-E-Mail:
• Updates: Verfügbar über den Joomla-Update-Server (ein Jahr ab Kaufdatum)