Meine Joomla-Anpassungen: Unterschied zwischen den Versionen

Aus aredn.dg5mgj.de
Zur Navigation springenZur Suche springen
 
(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 64x63 64x63+0+0 8-bit sRGB 2996B 0.000u 0:00.000
+
  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 nach einem Update die Grafiken gleich zur Hand.
+
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-Guru ein 'Microsoft-Favicon? ===
+
=== Wie erzeugt ein Linux-User ein 'Microsoft-Favicon? ===
−
Natürlich mit einem Bash-Befehl:
+
Das Original als Vorlage wird als SVG-Datei mit Inkscape erzeugt und damit wird die passende PNG-Dateien (256x256px) exportiert.
−
  convert -resize x16 -gravity center -crop 16x16+0+0 favicon.png -flatten -colors 256 -background transparent favicon.ico
+
 
−
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.


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.