Joomla: Unterschied zwischen den Versionen

Aus Mediawiki Ferdinand Gruber
Zur Navigation springen Zur Suche springen
KKeine Bearbeitungszusammenfassung
 
(47 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Installation und Upgrade ==
[[Installation und Upgrade]]
Grundsätzlich genügt es bei Joomla, das neue Paket herunterzuladen und in das Joomla-Verzeichnis zu kopieren.
=== Download ===
Download der alten Version löschen
cd /srv/www/htdocs
rm Joomla*.zip
dir


[https://github.com/joomlagerman/joomla/releases Downloadseite der deutschen Version auf Github]
[[Upgrade Joomla Version 3 auf Version 4]]


Nun den Download Link kopieren und mit '''wget''' nach '''/srv/www/htdocs''' herunterladen
[[Joomla Templates]]
=== Entpacken ===
cd /srv/www/htdocs
mkdir temp/joomla_full 2> /dev/null
rm temp/joomla_full/* -R 2> /dev/null
unzip Joomla*zip -d temp/joomla_full
chown wwwrun.www temp/joomla_full -R
chmod 775 temp/joomla_full -R


=== Upgrade einer Joomla Instanz ===
[[Joomla Tipps]]
Name=/srv/www/htdocs/joomla_fg
rsync -av temp/joomla_full/* $Name
rm $Name/installation -R


=== Upgrade mehrerer Instanzen ===
[[Joomla Benutzerverwaltung]]
* Konsolenbefehl
Voraussetzung:
: Die Namen aller Joomla-Verzeichnisse müssen mit <code>joomla_</code> beginnen.
for i in joomla_* ; do rsync -av temp/joomla_full/* $i ; rm -R $i/installation 2> /dev/null ; php $i/cli/deletefiles.php ; done
* Upgrade Skript downloaden
https://t2792.greatnet.de/download/bash/joomla_upgrade.sh
Dieses Script fasst obige Befehlsfolgen in ein Programm zusammen - ohne Gewähr.
: Einfacher ist es, die Befehlsfolgen der Reihe nach über die Zwischenablage in ein Terminal zu kopieren. So mache ich es bei jedem Joomla Update - und das gibt es ja oft genug.


=== Troubleshooting ===
[[Phoca Joomla Extensions]]
==== Datenbank Reparatur im Browser direkt aufrufen ====
cd /srv/www/htdocs/my_joomla_instanz
administrator/index.php?option=com_installer&task=database
==== Keine Aktulisierungen vorhanden ====
Joomla ist offensichtlich nicht aktuell aber es wird angezeigt, dass keine Aktualisierungen verfügbar sind
Erweiterungen / Verwalten / Aktualisieren
Dann auf den Button <tt>Leeren</tt> klicken.
: Es wird der '''Cache''' geleert.


== Templates ==
[[Joomla Security und Troubles]]
=== Template Beeze3 ===
==== Konfiguration im Backend ====
* Standard Stil definieren
Erweiterungen / Templates / Stile
<code>Beez3 - default</code> als Standardstil setzen
* Modulpositionen anpassen
position-7
Im Template Manager kann man einstellen, dass die Module links oder rechts vom Content positioniert werden.
Position of Navigation: before content
==== CSS Definitionen ====
In folgender Datei kann man Stile definierten, die bei einem Update des Templates nicht überschrieben werden
templates/beez3/css/user.css
* Hintergrundbild im Header ändern
Das gewünschte Hintergrundbild speichern
templates/beez3/images/header.png
CSS Definitionen:
#header { padding-top: 0;
.logoheader {
    background: #FFFFFF URL(../images/header.png) no-repeat
    min-height: ... (wegen Hintergrundbild)
...
}
==== Eigene CSS Definitionen im Editor ====
* Die Erweiterung [https://www.joomlacontenteditor.net/downloads/editor/core/latest?catid=130 JCE Editor] downloaden und installieren
* Konfiguration
JCE - Editor Global Configuration / Editor Styles
Custom CSS File / templates/$template/css/user.css
==== Overrides ====
Will man Komponenten und Module ändern, sollte man einen '''Output Override''' erstellen, damit die Änderungen nicht beim nächsten Update überschrieben werden.
* Im Backend
Erweiterungen / Templates / Templates / Beez3 Details und Dateien
Overrides erstellen
Die erstellten Overrides befinden sich dann im Verzeichnis
templates/beez3/html
Man kann die Dateien mit einem beliebigen Editor oder gleich im Joomla Backend bearbeiten.
 
[https://www.vi-solutions.de/de/tips-vom-joomla-spezialist/423-output-layout-override Weitere Informationen]
 
=== Template Phoca Gweld ===
Alle Formatierungen befinden sich in einer einzigen CSS Datei im Template
.../css/template.css
* Blaue Umrandung im Bootstrap Dropdownmenü entfernen
Folgende Zeile an 3 Stellen auskommentieren
border-bottom: 3px solid transparent;
 
== Eigene CSS Klassen ==
=== Globale CSS Styles definieren ===
* Eigene CSS Datei
Eigene Klassen können in jeder CSS Datei des Templates definiert werden.
Am besten aber in folgender Datei definieren
css/custom.css
* Extension zum Einbinden der eigenen CSS Datei
Folgendes Plugin bindet die CSS Definitionen aus der eigene CSS Datei automatisch ein
Add Custom CSS
Download: [https://joomla.impression-estudio.gr/?dlp=5ddd73ab19cbd Extension: Add Custom CSS]
 
Plugin installieren, konfigurieren und freischalten:
: Den Pfad zur eigenen CSS Datei eingeben, Beispiel:
templates/protostar/css/custom.css
Die CSS Definitionen werden dann in den HEAD der Seite direkt eingefügt:
<style type="test/css">
    ...
* CSS Datei für den Editor erzeugen
: In der Version 1.2.1 von '''Add Custom Css''' ist das offensichtlich nicht mehr notwendig. Man kann in der Plugin Konfiguration das Plugin für Frontend und Backend freischalten.
Folgendes gilt also für frühere Versionen
: Die gleichen Klassen mit den gleichen Eigenschaften auch in folgender Datei definieren
css/editor.css
Diese Datei eventuell als Symlink von custom.css erzeugen.
 
=== CSS Klassen für eine bestimmte Seite ===
* Eine neue CSS Klasse definieren
In der CSS Datei des Templates eine eigene Klasse für ein bestimmtes Element definieren
# Beispiel für einen Tabellenstil
table.content_table {
  border-collapse:collapse;
  width:100%;
}
.content_table td {
    border:1px solid #CCC;
    padding: 4px;
}
* Die CSS Klasse im Backend zuweisen
Im Backend einen Menülink bearbeiten, der den Artikel aufruft, in dem die neue CSS Klasse angewendet werden soll.
 
In das Feld '''Seitenklasse''' den Namen der Klasse mit einem '''führenden Leerzeichen''' eingeben.
Einstellungen der Seitenanzeige / Seitenklasse
Seitenklasse: content_table
 
== Tipps und Tricks ==
=== Iframe Wrapper ===
==== Iframe Wrapper im Content ====
* Wrapper Modul erstellen
Das Modul vom Typ Wrapper dient dazu fremdes HTML in einem '''Iframe''' darzustellen.
* Position des Moduls angeben
Verwendet man eine im Template definierte Position, dann erscheint der Iframe an dieser Stelle der Joomla Website.
: Man kann aber eine eigene Position mit beliebigem Namen (z.B '''iframePosition''') definieren. Mit Hilfe dieses Positionsnamens lässt sich dann das Wrapper Modul im Content platzieren.
* Iframe im Beitrag positionieren
Folgende Zeile in den Beitrag einfügen:
{ loadposition iframePosition }
Der Positionsname bezieht sich auf obiges Beispiel.
 
==== Iframe-Wrapper deaktiviert JQuery ====
Ich habe festgestellt, dass nach dem Laden einer Iframe-Wrapper Seite die Bootstrap-DropDown Menüs nicht mehr funktionieren. Anscheinend wird JQuery deaktiviert nach Laden des Iframe-Wrappers.
: Es wird übrigens auch Jquery-UI deaktiviert.
Lösung:
: In die '''index.php''' des Templates folgende Zeilen einfügen
JHtml::_('jquery.framework');
JHtml::_('jquery.ui', array('core'));
 
==== Iframe Wrapper und SSL ====
Nach Umstellung der Joomla Site auf SSL bzw. wenn Apache SSL erzwingt, werden IframeWrapper Seiten nicht mehr angezeigt.
: Im '''IframeWrapper''' muss die Option '''Erweitert / Hinzufügen''' ausgeschaltet werden, sonst beginnt der Link immer mit http (statt https).
 
==== GET_Parameter an Wrapper übergeben ====
Folgende Datei im Template muss vorhanden sein und bearbeitet werden:
.../template/html/com_wrapper/wrapper/default.php
Im folgenden Code unmittelbar vor dem Iframe werden einige Parameter an den Iframe-Wrapper übergeben, die dann von dem PHP Skript ausgewertet werden können.
// *******************************
// Parameter an Wrepper übergeben:
// *******************************
if ( strstr ($this->wrapper->url,"?")  ) $this->wrapper->url .= "&referer=joomla";
    else $this->wrapper->url .= "?referer=joomla";
      $user = JFactory::getUser();
      if ( $user->username ) $this->wrapper->url .=
          "&user=".$user->username.
          "&userfullname=".$user->name.
          "&groups=".implode(",",$user->get('groups'));
// *******************************  ?>
<iframe <?php echo $this->wrapper->load; ?>
 
=== Bilder ausrichten ===
Mit den Klassen
img-fulltext-left
img-fulltext-right
werden die Bilder entsprechend positioniert und bekommen automatisch einen Abstand zum umlaufenden Text.
=== Bilder untereinander anordnen ===
Das geht mit dem grafischen Editor nicht wirklich gut. Daher gehe ich so vor:
Ich füge zuerst die Bilder in den Text irgendwo ein und bringe sie auf die richtige Größe. Dann erzeuge ich im HTML Modus einen DIV Container:
<pre>
<div style="width: 160px; float: left;">
 
</div>
</pre>
Zwischen diese obigen zwei Zeilen kopiere ich dann die Codezeilen der Bilder hinein, dann schaut das ganze etwa so aus:
<pre>
* linksbündig
<div style="width: 160px; float: left;>
<img src="images/stories/joomla-dev_cycle.png" width="150" />
<img src="images/stories/clock.jpg" width="150" />
</div>
 
* rechtsbündig
<div style="width: 160px; float: right;">
<img src="images/stories/joomla-dev_cycle.png" width="150" />
<img src="images/stories/clock.jpg" width="150" />
</div>
</pre>
Die Breite  der Bilder <code>width</code> ist etwas weniger als die Breite des Containers, wie man sieht sieht.
 
=== Einfaches Datumsformat ohne Uhrzeit ===
Folgende Datei bearbeiten: '''language/de-DE/de-De.ini'''
# DATE_FORMAT_LC2=%A, den %d. %B %Y um %H:%M Uhr
DATE_FORMAT_LC2=%d. %B %Y
=== Angabe des Autors verkürzen ===
Folgende Datei bearbeiten: '''language/de-DE/de-De.com_content.ini'''
# WRITTEN BY=Geschrieben von: %s
WRITTEN BY=%s
=== Template kopieren ===
Einige Templates gehören zum Joomla Core. Wenn man eines von diesen Templates verwendet und Anpassungen durchgeführt hat, werden diese beim Update überschrieben. Man kann seit Joomla 2.5 das Template im Backend kopieren.
 
=== Joomla Druckvorschau bzw. Druckausgabe formatieren ===
Die Druckvorschau wird durch das Skript <code>component.php</code> erzeugt:
/templates/system/component.php
Dafür wird die CSS Klasse '''contentpane''' verwendet. Für diese Klasse kann man in der CSS Datei des verwendeten Templates (template.css) Formatierungen festlegen, z.B.: eine Mindestbreite des Containers.
.contentpane {
    min-width: 720px;
}
'''Achtung:''' Die direkte Druckausgabe wird nicht über component.php gesteuert. Dazu muss im Head Bereich der index.php des Templates ein Verweis zu einer print.css eingefügt werden:
  <link rel="stylesheet" type="text/css" media="print" href="<?php echo $templateUrl; ?>/css/print.css" />
 
=== Kalender PopUP formatieren ===
* Wochenanfang auf Montag legen
# /media/system/js/calendar-setup.js
param_default("firstDay",1);
* SA und SO sichtbar machen
In folgender Datei in Zeile 46 den Farbwert <code>#dedede</code> durch <code>#777777</code> ersetzen.
# /media/system/css/calendar-jos.css
 
=== Modulpositionen anzeigen ===
An die URL den Querystring <code>?tp=1</code> anhängen
: Beispiel: http://t2792.greatnet.de/joomla_sieglinde?tp=1
== Benutzer ==
=== Gruppen und Zugriffsebenen ===
https://blog.formativ.net/joomla-benutzergruppen-und-zugriffsebenen/
=== Benutzeranmeldung mit Modul ===
Ein Modul vom Typ '''Benutzer-Anmeldung''' auf der Seite platzieren - eventuell in der Navigationsleiste.
: Dies ist die einfachere Variante mit dem einzigen Nachteil, dass etwas mehr Platz benötigt wird. Der Vorteil ist, dass die An- und Abmeldeweiterleitung einfach zu realisieren sind, d.h. man kann auf die zuletzt angezeigte Seite weiterleiten (Standard).
 
=== Benutzeranmeldung mit einem Menüeintrag ===
Einen Menüeintrag vom Typ '''Benutzer-Anmeldeformular''' erzeugen.
: Nachteil: Die An- und Abmeldeweiterleitung vom Typ '''Standard''' leitet weiter zum Anmeldeformular, da die zuletzt angezeigte Seite eben das Anmeldeformular ist.
Das ist nicht sehr sinnvoll. Man kann statt der Standard-Option einen bestimmten Menüeintrag als Weiterleitungsziel nehmen, z.B. die Startseite der Joomla-Site.
 
=== Login Menüpunkt ausblenden ===
Möchte man nach Anmeldung eines Benutzer den Menüpunkt '''Login''' ausblenden, so muss man einige Änderungen in der Benutzerverwaltung durchführen.
* Eine neue Benutzergruppe anlegen
# Beispiel:
Name: NonRegistered
: Hinweis: Ab Joomla 3 wird angeblich eine Benutzergruppe '''Gast''' automatisch nach der Installation angelegt.
* Eine neue Zugriffsebene anlegen
# Beispiel:
Name: Gast
Nur die neue Benutzergruppe '''NonRegistered''' soll Zugriff haben (anklicken).
* Zugriffsebene Public ändern
In der Zugriffsebene '''Public''' muss nun die neue Gruppe '''NonRegistered''' zusätzlich aktiviert werden.
* Benutzer Optionen ändern
Auf das Optionen Symbol klicken (rechts oben) und als '''Gast Benutzergruppe''' die neue Gruppe '''NonRegistered''' eintragen.
 
=== Authentifizierung über LDAP ===
* Das Plugin '''Authentifikation - LDAP''' aktivieren
* Plugin konfigurieren
Host:        localhost
Port:        389
LDAP V3:    Ja
Autorisierungsmethode: Verbinden und Suchen
Basis-DN:    dc=network
Suchstring:  &(uid=[search]) (gidNumber=601)
Voller Name: gecos
E-Mail:      mail
Benutzer-ID: uid
Hinweis: Das LDAP Attribut '''mail''' muss bei jedem Benutzer vorhanden sein.
 
== Phoca Gallery ==
=== Konfiguration und Anwendung ===
* Phocagallery Plugin
Zur Phocagallery gibt es ein Plugin, mit dem man in einen Beitrag Fotos aus einer Galerie einbinden kann.
: http://www.phoca.cz/download/category/14-phoca-gallery-plugin
Folgende Zeile in den Artikel einfügen:
# Beispiel
{phocagallery view=category|categoryid=15}
Nach der Installation muss das Plugin '''aktiviert''' werden.
 
==== Optionen ====
* Thumbnails
Große Thumbnails = Detailansicht: 800 x 600
Mittlere Thumbnails: 175 x 175
Kleine Thumbnails: 100 x 100
 
Detail Fenstergröße: 820 x 680
=== Bildergalerie hinzufügen ===
==== Upload ====
Am Server ein neues Verzeichnis erstellen
images/phocagallery/neuerOrdner
Fotos mit Dateimanager, z.B. Dolphin oder mit einem FTP Client, z.B. Filezilla, in den neuen Ordner hochladen
: Sicherstellen, dass der Benutzer <tt>wwwrun</tt> (... wenn openSuse) Schreibrechte in diesem Ordner hat
 
=== Joomla Backend ===
Komponenten / Phocagallery / Bilder / Mehrfaches Hinzufügen
Auf der rechten Seite werden alle Gallery Ordner angezeigt. Den neuen Ordner auswählen per Checkbox und dann auf <tt>Speichern und Schließen</tt> klicken.
 
Nun sollten die Thumbnails automatisch generiert werden.
 
Falls ein Fehler auftritt, wird der Vorgang abgebrochen und die automatische Thumbnailerstellung deaktiviert. Im Phocagallery Kontrollzentrum kann man unter <tt>Optionen</tt> diese wieder einschalten.
 
== Phoca Mail ==
=== Abmelden vom Newsletter nicht möglich ===
In der Komponente JCE Editor muss man '''Relative URLs''' einschalten.
JCE Administration / Editor Profiles / Default / Editor Parameters
 
== Weblinks with thumbshots ==
* Download und Installation
Download von der Website des Autors: [http://www.bretteleben.de/lang-en/joomla/weblinks-with-thumbshots.html http://www.bretteleben.de/lang-en/joomla/weblinks-with-thumbshots.html]
 
Nach der Installation muss diese Erweiterung im Joomla Backend eingeschaltet werden: '''Enable it'''
 
Durch diese Erweiterung zeigt Joomla kleine Vorschaubilder an anstatt der Standardsymbole für Weblinks.
 
Die Komponente überschreibt nur 3 Dateien der originalen Joomla Weblinks Komponente. Die Originaldateien werden gesichert und wieder zurück kopiert, wenn die Komponente ausgeschaltet wird.
 
Geänderte Dateien:
# /srv/www/htdocs/joomla_fg/administrator/components/com_weblinkswt/backup>
./config.xml
./default_items.php
./view.html.php
 
* Konfiguration
Es muss ein Thumbshot-Server in die Konfiguration eingetragen werden.
Übernimmt man den vorgegebenen Eintrag, werden aber anscheinend keine Thumbs erzeugt:
# Default Konfiguration
<pre>http://open.thumbshots.org/image.pxf?url=#URL#</pre>
 
# Anderer Server, der funktioniert:
<pre>http://www.thumbshots-server.com/webthumb/webthumb.php?url=#URL#</pre>
Damit beim Erstellen eines neuen Menüpunktes zu einer Weblinks-Kategorie der geänderte Servereintrag übernommen wird, muss man offensichtlich auch noch in folgender Datei den Server eintragen bzw. ändern:
administrator/components/com_weblinks/config.xml
 
== Sicherheit ==
===Kontaktformular gegen SPAM Bots absichern===
Folgende Datei  bearbeiten:
/components/com_contact/views/contact/tmpl/default_form.php
* Ein '''verstecktes''' Formularfeld hinzufügen:
<input type="text" name="security" style="'''display: none;'''">
Die JavaScript Funktion '''validate_form''' ändern:
...
if (frm.security === "") {
    frm.submit();
}
Ein SPAM Bot wird automatisch alle Felder ausfüllen. Das Formular wird jedoch nur dann abgeschickt, wenn dieses versteckte Feld leer ist.
=== reCAPTCHA ===
==== Plugin aktivieren ====
Im Joomla Backend das Plugin <code>Captcha - reCAPTCHA</code> aktivieren.
==== Schlüssel beziehen ====
Man muss einen öffentlichen und einen geheimen Schlüssel eingeben.
: Diese zwei Schlüssel bekommt man, indem man auf folgender Seite jene Domain registriert, über welche die Joomla Seite erreichbar ist.
https://www.google.com/recaptcha/admin
 
Klick auf das '+' Symbol rechts oben.
 
==== reCAPTCHA Version ====
* reCAPTCHA Version 2
* Kästchen ''Ich bin kein Roboter''
* Die zwei Schlüssel kopieren und im Joomla-Plugin einfügen
==== Kontaktformular ====
Im Joomla Backend muss unter <tt>Benutzer / Optionen"</tt> '''reCAPTCHA''' aktiviert werden, wenn es für das Kontaktformular verwendet werden soll.
:: Falls reCAPTCHA im Kontaktformular nicht erscheint, dann unter <tt>Komponenten / Kontakte / Option</tt> die Formulareinstellungen  überprüfen.
 
== Troubles ==
=== Komponenteninstallation nicht möglich ===
Fehlermeldung:
Es wurde kein Installationsplugin aktiviert ...
Lösung:
Erweiterungen / Verwalten / Überprüfen
Die gewünschten Installtionsplugins auswählen und auf '''Installieren''' klicken und dann ...
Erweiterungen / Plugins
... die neu installierten Installer - Plugins aktivieren.
=== HTML wird entfernt nach Speichern einer Seite ===
Für die Benutzergruppe ist ein Textfilter gesetzt auf den Wert '''Kein HTML'''
Joomla | Globale Konfiguration | Textfilter
Den Textfilter ändern auf den Wert '''Keine Filterung'''
 
== Overrides ==
 
=== Offline Seite ===
Die Offline Seite kann man durch eigenen Code ersetzen bzw ergänzen.
: Folgende Datei in den Ordner <code> template/mein_template </code> kopieren und bearbeiten:
template/system/offline.php
: Joomla verwendet dann nicht diese Standardseite im system Verzeichnis, sondern den Override im aktuell verwendeten Template.
Ich habe eigenen Code eingebunden und den unnötigen Rest teilweise entfernt.
<pre>
<body>
  <jdoc:include type="message" />
  <div id="frame" class="outline">
      require_once("/srv/www/include/php/application.php");
      echo application::renderOfflinePage(array(
        "caption"=>"Titel meiner Webseite",
        "days"=>0,
        "hours"=>2
      )); ?>
    </div>
</body></pre>
Die hier aufgerufene Funktion <code>application::renderOfflinePage</code>zeigt an, wie lang die Seite offline ist.
 
Hier der Code meiner Offline Funktion:
<pre>
static function renderOfflinePage($params=array()) {
    date_default_timezone_set('Europe/Vienna');
    foreach ( $params as $key => $value ) $$key = $value;
 
    $start = mktime(date('H'), 0, 0, date("m"), date("d") , date("Y"));
    $sec = ($days * 24 + $hours) * 60 * 60;
    $ende_timestamp = $start + $sec;
    $Uhrzeit = strftime ("%H:00",$ende_timestamp);
    if ( $days == 0 ) {
        $Datum = "heute";
    } else {
        $Datum = strftime ("%d. %B %Y",$ende_timestamp);
    }
    $return = "<h1>Wartung</h1>";
    $return .= "<h2>".$caption."</h2>";
    $return .=  "<p>Diese Seite ist voraussichtlich bis <strong>".$Datum." ".$Uhrzeit."</strong> nicht verfügbar.</p>";
    $return .=  "<p>Bitte um Verständnis.</p>";
    $return .=  "<a href='mail@example.com'>Mail</a>an Webmaster.";
    return $return;
} </pre>

Aktuelle Version vom 11. Dezember 2024, 18:46 Uhr