Installation und Updates

Genossi ist ein WordPress-Theme von Lukas Köhler. Du installierst es in deiner eigenen WordPress-Website. Wenn du nur Texte oder Termine pflegen möchtest und Genossi bereits eingerichtet ist, beginne bei Erste Schritte.

Was du brauchst

Du brauchst eine WordPress-Installation bei einem Hoster und einen Zugang mit Administrationsrechten. Genossi setzt mindestens WordPress 6.6 und PHP 8.1 voraus. Richte beim Hoster die gewünschte Domain und HTTPS ein, bevor du die Website veröffentlichst.

Für eine neue Website brauchst du keine Datenbank aus der Entwicklungsumgebung. Die ZIP-Datei enthält das Theme. Deine eigenen Inhalte, Fotos und Zugangsdaten ergänzt du in WordPress.

Genossi installieren

1. Lade die aktuelle ZIP-Datei über Download auf der Startseite herunter. Entpacke sie nicht.
2. Melde dich in WordPress an und öffne Design → Themes → Theme hinzufügen → Theme hochladen.
3. Wähle die ZIP-Datei aus, klicke auf Jetzt installieren und danach auf Aktivieren.
4. Öffne Werkzeuge → Website einrichten. Für eine Website ohne Beispielinhalte entfernst du das Häkchen bei Platzhalter-Beiträge sowie Pressespiegel- und Transparenz-Einträge. Lasse die Option zum Überschreiben vorhandener Inhalte ausgeschaltet.
5. Klicke auf Jetzt einrichten.

Die Einrichtung legt deutsche und englische Seiten, Kategorien und Navigationsmenüs an. Sie setzt außerdem die Startseite und die Zeitzone auf Berlin. Bei der ersten Einrichtung bekommen Beitragsadressen Jahr und Monat. Deinen Website-Namen, Benutzerprofile und ein bereits gewähltes Logo behält Genossi bei.

Neue Websites enthalten zunächst neutrale Texte und Bildplätze. Persönliche Fotos und Social-Media-Konten sind nicht voreingestellt.

Die Website für dich anpassen

Arbeite die angelegten Seiten einmal durch, bevor du die Website freigibst.

• Trage unter Einstellungen → Allgemein Titel und Untertitel deiner Website ein. Eine Bühne ohne eigenen Titel verwendet den Website-Titel.
• Wähle unter Design → Editor dein Logo. Bearbeite die Vorstellung, die Über-mich-Seite und den Fußbereich. Wie das geht, steht unter Design und Navigation.
• Ersetze die Texte in Impressum und Datenschutz durch Angaben, die zu deiner Website passen. Die angelegten Texte sind Platzhalter.
• Ergänze unter Genossi CMS → Social Media deine Profile und öffentlichen Kontaktangaben. Für einen Mastodon-Profillink brauchst du kein Zugangstoken. Für Ankündigungen richtest du die Mastodon-Integration gesondert ein.
• Prüfe die Kontaktseite. Die Kontaktkarte übernimmt die Angaben beim Einfügen. Nach späteren Änderungen der Einstellungen musst du eine bestehende Kontaktkarte selbst bearbeiten oder neu einfügen.
• Wähle unter Benutzer → Profil deinen öffentlichen Anzeigenamen. Lade unter Medien eigene Fotos hoch und wähle sie in Bühne, Karussell und Presseportal aus.

Öffne die Website anschließend auch abgemeldet und auf dem Handy. Prüfe Menü, Links, Kontaktangaben und Formulare. Teste mit deinem Hoster, ob E-Mails von WordPress ankommen. Eine vorhandene Kontaktadresse allein richtet den E-Mail-Versand noch nicht ein.

Platzhalter entfernen

Wenn du bei der Einrichtung Beispielinhalte angelegt hast, findest du auf der Website Beiträge und Einträge mit Lorem-ipsum-Text. Öffne Werkzeuge → Website einrichten und klicke auf Platzhalter löschen.

Die Sammelfunktion verschiebt nur unveränderte, vom Theme gekennzeichnete Beispiele in den Papierkorb. Bearbeitete Beispiele bleiben erhalten und verlieren ihre Platzhalter-Markierung. Prüfe sie anschließend einzeln. Ältere Beispiele ohne Herkunftsnachweis bleiben ebenfalls stehen. Wenn der WordPress-Papierkorb abgeschaltet ist, löscht die Sammelfunktion die Beispiele nicht endgültig. Fotos bleiben in der Mediathek.

Fehlende Seiten wieder anlegen

Du kannst Werkzeuge → Website einrichten erneut ausführen, etwa wenn eine benötigte Seite fehlt. Lasse dabei das Häkchen zum Überschreiben ausgeschaltet.

Bearbeitete Seiten, Menüs sowie Kopf- und Fußbereiche behalten ihre Inhalte. Unbearbeitete, noch vom Theme verwaltete Seiten können die aktuellen Vorlagen erhalten. Eine bereits gewählte Datenschutzseite behält ihren bisherigen Status. Ein Entwurf bleibt ein Entwurf. Bereits bearbeitete Seiten behalten ihren gewählten Seitentyp und deine gewählten Beitragsadressen bleiben bestehen.

Die Überschreiben-Option ersetzt vorhandene Inhalte durch die Theme-Vorlagen. Verwende sie nicht auf einer Website, deren Texte du behalten möchtest.

Genossi aktualisieren

1. Sichere vor dem Update Datenbank und Dateien deiner WordPress-Website. Dein Hoster kann dir sagen, wie du die Sicherung wieder einspielst. Bei einer bestehenden Website solltest du das Update zuerst in einer Testkopie prüfen.
2. Lade die neue ZIP-Datei von der Startseite herunter.
3. Öffne Design → Themes → Theme hinzufügen → Theme hochladen und wähle die ZIP-Datei aus.
4. WordPress erkennt das vorhandene Theme. Vergleiche die angezeigten Versionen und bestätige Aktuelles durch hochgeladenes ersetzen, wenn die neue Version stimmt.
5. Prüfe wichtige Seiten und Funktionen abgemeldet. Falls eine alte Fassung erscheint, öffne oben im Menü unter dem Website-Namen Cache leeren.

Ein Theme-Update ersetzt die Dateien des Themes. Deine in WordPress gespeicherten Beiträge, Seiten und Einstellungen bleiben erhalten. Änderungen, die du direkt an Theme-Dateien vorgenommen hast, gehen beim Ersetzen verloren. Du musst die Website-Einrichtung nach einem Update nicht mit der Überschreiben-Option neu ausführen.

Vom früheren Theme Erik Uden wechseln

Bis Version 1.3 hieß das Theme Erik Uden. Installiere die Genossi-ZIP und aktiviere Genossi. Es übernimmt die vorhandenen Inhalte, Einstellungen, Menüs und bearbeiteten Vorlagenteile. Prüfe anschließend die Website. Wenn alles stimmt, kannst du das alte Theme unter Design → Themes löschen.

Hinweise für die technische Betreuung

Die Einrichtung ist auch über WP-CLI möglich. wp genossi setup --skip-demo legt die Struktur ohne Beispielinhalte an. Lasse --force weg, damit bearbeitete Inhalte erhalten bleiben. Mit wp genossi demo lassen sich Beispiele erneut anlegen, mit wp genossi demo --delete entfernst du unveränderte Beispiele.

Bei älteren Bildern legt Genossi im Hintergrund WebP-Kopien an. Nach einem Fehler folgen höchstens drei automatische Versuche, mit fünf und danach 25 Minuten Abstand. wp genossi images startet die Verarbeitung unmittelbar. Mit wp genossi images --retry-errors lässt sich ein weiterer Durchlauf für Fehler anstoßen. Originale und bestehende Bildadressen bleiben erhalten.

Die zusätzliche Server-Einrichtung steht im WordPress-Menü Dokumentation. Bei alten Installationen muss der Hoster frühere nginx-Regeln zur direkten HTML-Auslieferung entfernen, damit Ablaufzeit und Wartungsmodus geprüft werden. Die Anleitung dazu steht im Performance-Leitfaden des Repositorys.