Meine Joomla-Anpassungen: Unterschied zwischen den Versionen
DG5MGJ (Diskussion | Beiträge) |
DG5MGJ (Diskussion | Beiträge) |
||
| (20 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
== Eigene CSS-Datei einbinden == | == Eigene CSS-Datei einbinden == | ||
Im Backend unter '''System - Templates - Anpassen (Cassiopeia)''' die Datei „/media/templates/site/cassiopeia/css/user.css“ eine neue Datei anlegen und bearbeiten:<br> | Im Backend unter '''System - Templates - Anpassen (Cassiopeia)''' die Datei „/media/templates/site/cassiopeia/css/user.css“ eine neue Datei anlegen und bearbeiten:<br> | ||
| − | Damit wird die eigene CSS-Datei zusätzlich eingebunden ohne dass Kopien von Theme-Styles modifiziert werden müssen. Da diese bei einem Update nicht verändert und bei Vorhandensein automatisch eingebunden wird, benötigt es keine weitere Anpassung. | + | Damit wird die eigene CSS-Datei zusätzlich eingebunden ohne dass Kopien von Theme-Styles modifiziert werden müssen. Da diese bei einem Update nicht verändert und bei Vorhandensein automatisch eingebunden wird, benötigt es keine weitere Anpassung und Sicherheitsmaßnahmen. |
---- | ---- | ||
| − | == Wo ist das favicon.ico bei Joomla? == | + | == Wo ist das favicon.ico bei Joomla abgelegt? == |
| − | Das ist nicht so einfach zu beantworten, denn das hat sich von Hauptversion zu Hauptversion geändert. Da ich mit Joomla 5 arbeite kann ich davon berichten und auch, dass bei einem Update der Joomla-Software das favicon meisst überschrieben wird. Also muss man das eigene favicon sicher aufbewahren und dann wieder "einbauen". | + | Das ist nicht so einfach zu beantworten, denn das hat sich von Hauptversion zu Hauptversion geändert und ist auch je Template anders. Da ich mit '''Joomla 5''' und dem '''Template Cassiopeia''' arbeite kann ich davon berichten und auch, dass bei einem Update der Joomla-Software das favicon meisst überschrieben wird. Also muss man das eigene favicon sicher aufbewahren und dann wieder "einbauen". |
| − | Die Ablage der Favicon-Grafik ist bei Joomla5 hier zu finden: <code>/media/system/images</code><br> | + | Die Ablage der Favicon-Grafik ist bei Joomla5 mit dem Template Cassiopeia hier zu finden: <code>/media/system/images</code><br> |
Allerdings findet man dort viele Grafiken dazu: | Allerdings findet man dort viele Grafiken dazu: | ||
favicon.ico image/vnd.microsoft.icon | favicon.ico image/vnd.microsoft.icon | ||
| − | favicon.png PNG | + | favicon.png PNG 64x64 64x64+0+0 8-bit sRGB 2996B 0.000u 0:00.000 |
joomla-favicon-pinned.svg viewBox="0 0 16 16" | joomla-favicon-pinned.svg viewBox="0 0 16 16" | ||
joomla-favicon.svg viewBox="0 0 149.7 149.6" | joomla-favicon.svg viewBox="0 0 149.7 149.6" | ||
| Zeile 24: | Zeile 24: | ||
<link href="/media/system/images/favicon.ico" rel="alternate icon" type="image/vnd.microsoft.icon"> | <link href="/media/system/images/favicon.ico" rel="alternate icon" type="image/vnd.microsoft.icon"> | ||
<link href="/media/system/images/joomla-favicon-pinned.svg" rel="mask-icon" color="#000"> | <link href="/media/system/images/joomla-favicon-pinned.svg" rel="mask-icon" color="#000"> | ||
| − | So habe ich all diese erforderlichen Grafiken erstellt und an der entsprechenden Stelle abgelegt. Zusätzlich habe ich einen Unterordner erstellt, in dem diese noch einmal abgelegt sind | + | So habe ich all diese erforderlichen Grafiken erstellt und an der entsprechenden Stelle abgelegt. Zusätzlich habe ich einen Unterordner erstellt, in dem diese noch einmal abgelegt sind und ich habe nach einem Update die Grafiken gleich zur Hand. |
| − | === Wie erzeugt ein Linux- | + | === Wie erzeugt ein Linux-User ein 'Microsoft-Favicon? === |
| − | + | Das Original als Vorlage wird als SVG-Datei mit Inkscape erzeugt und damit wird die passende PNG-Dateien (256x256px) exportiert. | |
| − | convert | + | |
| − | Das setzt natürlich die Quelldatei als png voraus ;-) | + | Mit einem Bash-Befehl wird dann die Microsoft-Version des Favicons erzeugt: |
| + | $ '''convert MeingrossesLogo.png -define icon:auto-resize=256,64,48,32,16 favicon.ico''' | ||
| + | Das setzt natürlich die Quelldatei als png-Bild im aktuellen Verzeichnis voraus und dort entsteht dann das favicon.ico. Dieses hat dann für unterschiedliche Darstellungsgrößen die passenden Größen parat: 256x256 bis 16x16 Pixel. Die Quelle sollte also die Minimalgröße von 256x256 haben. | ||
| + | ---- | ||
| + | |||
| + | === PHP-Script zur Restaurierung der Favicons === | ||
| + | Leider werden diese Favicons bei einem Joomla-Update gnadenlos überschrieben, so lege ich ein Unterverzeichnis an, in dem "meine" Favions abgelegt werden: <code>/media/system/images/.MyFavicons</code> | ||
| + | |||
| + | Somit habe ich mir ein kleines PHP-Script erzeugt, welches nach einem Update von Jommla! aufgerufen wird und "meine" Favicons wieder an die richtige Stelle kopiert. Die vorhandenen Dateien werden dann auch gnadenlos überschrieben. | ||
| + | <nowiki><pre><?php | ||
| + | $DstPath = $_SERVER['DOCUMENT_ROOT'] . 'media/system/images/'; | ||
| + | $SrcPath = $DstPath . '.MyFavicons/'; | ||
| + | $MyFavicons = scandir($SrcPath); | ||
| + | /**/ echo "\n<!-- MyFavicons = "; var_dump($MyFavicons); echo " -->\n"; | ||
| + | |||
| + | foreach ($MyFavicons as $Line => $File) | ||
| + | { | ||
| + | if (substr($File,0,1) == "." ) | ||
| + | { | ||
| + | echo "ignore Dotfile: " . htmlspecialchars($File) . "<br />\n"; | ||
| + | } | ||
| + | else | ||
| + | { echo "Copy Favicon: " . htmlspecialchars($File) . "<br />\n"; | ||
| + | if (!copy($SrcPath.$File, $DstPath.$File)) { echo "ERROR! failed to copy $File ...\n"; } | ||
| + | } } | ||
| + | ?>__________________________________________________________________________________________</pre></nowiki> | ||
| + | Die Nutzung der Variablen <code>$_SERVER['DOCUMENT_ROOT']</code> erspart ein mühsames Heraussuchen des Komplettpfades und ist für jeden Webspace gültig. Ein Mehrfachaufruf ist auch möglich und schadet nicht... | ||
== Login-Formular im Offline-Status ausblenden == | == Login-Formular im Offline-Status ausblenden == | ||
Aktuelle Version vom 2. Dezember 2025, 04:05 Uhr
Einige meiner Projekte werden mit dem CMS Joomla betrieben. Derzeit ist die Version 5 aktuell und für diese mit dem Template CASSIOPEIA habe ich Anpassungen durchgeführt damit ich das Template erweitert anpassen kann und werde diese hier für mich dokumentieren.
Achtung: Wer dies nachmacht, handelt auf eigene Gefahr!
Informationen zu PHP, JavaScript, HTML4 und CSS findet man in den entsprechenden Informationsseiten im Internet.
Inhaltsverzeichnis
Eigene CSS-Datei einbinden
Im Backend unter System - Templates - Anpassen (Cassiopeia) die Datei „/media/templates/site/cassiopeia/css/user.css“ eine neue Datei anlegen und bearbeiten:
Damit wird die eigene CSS-Datei zusätzlich eingebunden ohne dass Kopien von Theme-Styles modifiziert werden müssen. Da diese bei einem Update nicht verändert und bei Vorhandensein automatisch eingebunden wird, benötigt es keine weitere Anpassung und Sicherheitsmaßnahmen.
Wo ist das favicon.ico bei Joomla abgelegt?
Das ist nicht so einfach zu beantworten, denn das hat sich von Hauptversion zu Hauptversion geändert und ist auch je Template anders. Da ich mit Joomla 5 und dem Template Cassiopeia arbeite kann ich davon berichten und auch, dass bei einem Update der Joomla-Software das favicon meisst überschrieben wird. Also muss man das eigene favicon sicher aufbewahren und dann wieder "einbauen".
Die Ablage der Favicon-Grafik ist bei Joomla5 mit dem Template Cassiopeia hier zu finden: /media/system/images
Allerdings findet man dort viele Grafiken dazu:
favicon.ico image/vnd.microsoft.icon favicon.png PNG 64x64 64x64+0+0 8-bit sRGB 2996B 0.000u 0:00.000 joomla-favicon-pinned.svg viewBox="0 0 16 16" joomla-favicon.svg viewBox="0 0 149.7 149.6"
Im Header der Site wird dann mit Optionen eingebunden, so dass sich jeder Browser seine Lieblingsgrafik laden kann. Der uralte IE möchte natürlich nur das favicon.ico wogegen moderne Browser oder auch Suchmaschinen-Bots gerne eine SVG-Grafik laden. So kann es passieren, dass im Browser und in den Lesezeichen alles passt, aber bei Suchmaschinen ein Joomla-Icon erscheint.
So schaut der HTML-Header für das favicon bei Joomla 5 Normalerweise aus:
<link href="/media/system/images/joomla-favicon.svg" rel="icon" type="image/svg+xml"> <link href="/media/system/images/favicon.ico" rel="alternate icon" type="image/vnd.microsoft.icon"> <link href="/media/system/images/joomla-favicon-pinned.svg" rel="mask-icon" color="#000">
So habe ich all diese erforderlichen Grafiken erstellt und an der entsprechenden Stelle abgelegt. Zusätzlich habe ich einen Unterordner erstellt, in dem diese noch einmal abgelegt sind und ich habe nach einem Update die Grafiken gleich zur Hand.
Wie erzeugt ein Linux-User ein 'Microsoft-Favicon?
Das Original als Vorlage wird als SVG-Datei mit Inkscape erzeugt und damit wird die passende PNG-Dateien (256x256px) exportiert.
Mit einem Bash-Befehl wird dann die Microsoft-Version des Favicons erzeugt:
$ convert MeingrossesLogo.png -define icon:auto-resize=256,64,48,32,16 favicon.ico
Das setzt natürlich die Quelldatei als png-Bild im aktuellen Verzeichnis voraus und dort entsteht dann das favicon.ico. Dieses hat dann für unterschiedliche Darstellungsgrößen die passenden Größen parat: 256x256 bis 16x16 Pixel. Die Quelle sollte also die Minimalgröße von 256x256 haben.
PHP-Script zur Restaurierung der Favicons
Leider werden diese Favicons bei einem Joomla-Update gnadenlos überschrieben, so lege ich ein Unterverzeichnis an, in dem "meine" Favions abgelegt werden: /media/system/images/.MyFavicons
Somit habe ich mir ein kleines PHP-Script erzeugt, welches nach einem Update von Jommla! aufgerufen wird und "meine" Favicons wieder an die richtige Stelle kopiert. Die vorhandenen Dateien werden dann auch gnadenlos überschrieben.
<pre><?php
$DstPath = $_SERVER['DOCUMENT_ROOT'] . 'media/system/images/';
$SrcPath = $DstPath . '.MyFavicons/';
$MyFavicons = scandir($SrcPath);
/**/ echo "\n<!-- MyFavicons = "; var_dump($MyFavicons); echo " -->\n";
foreach ($MyFavicons as $Line => $File)
{
if (substr($File,0,1) == "." )
{
echo "ignore Dotfile: " . htmlspecialchars($File) . "<br />\n";
}
else
{ echo "Copy Favicon: " . htmlspecialchars($File) . "<br />\n";
if (!copy($SrcPath.$File, $DstPath.$File)) { echo "ERROR! failed to copy $File ...\n"; }
} }
?>__________________________________________________________________________________________</pre>
Die Nutzung der Variablen $_SERVER['DOCUMENT_ROOT'] erspart ein mühsames Heraussuchen des Komplettpfades und ist für jeden Webspace gültig. Ein Mehrfachaufruf ist auch möglich und schadet nicht...
Login-Formular im Offline-Status ausblenden
Um den Login bei einer OFFLINE-Website für einfache Besucher nicht anzubieten, also kein Loginformular anzuzeigen, habe ich einen PHP-Code eingeführt, der den Block in der PHP-Template-Datei offline.php nur bei Angabe eines Parameters mit notwendiger Variable frei gibt.
Hier als einfaches Beispiel: https://www.MeineDomain.TLD/?enable=login
Nur damit wird bei Offline-Mode das Loginformular ausgegeben.
Wo wird der Code eingefügt? Suche in der Datei offline.php im Template-Ordner die Zeile mit: div class="login" und füge davor folgende Zeile ein:
</div>
<?php if ( htmlspecialchars($_GET['enable']) == "login" ) { ?>
<div class="login">
Das Ende dieses IF-Blocks schließe ich an der Stelle ab, an dem das Formular und der div-Block geschlossen wird:
</form>
</div><?php } ?>
Natürlich habe ich mir eine Sicherung vor und nach der Änderung angelegt, um bei einem Fehlverhalten auf das Original zurückzuschalten oder bei einem Update des Templates mit diff erneut den Patch einfügen zu können.