Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
de:2.0:probleme_rund_um_admidio [2017/08/26 11:07] – [Debugmodus setzen] ximexde:2.0:probleme_rund_um_admidio [2023/09/26 20:15] (current) fasse
Line 1: Line 1:
 ====== Tipps und Tricks ====== ====== Tipps und Tricks ======
  
-===== Hilfreiche Informationen bei Fehlern/Problemen =====+===== Hilfreiche Informationen bei Problemen =====
 Wenn Admidio einmal nicht wie gewünscht funktioniert und deshalb im Forum etc um Hilfe gesucht wird, bitte immer ein paar zusätzliche Informationen mit angeben damit wir Admidio-Entwickler den Fehler einfacher und schneller finden können. Wenn Admidio einmal nicht wie gewünscht funktioniert und deshalb im Forum etc um Hilfe gesucht wird, bitte immer ein paar zusätzliche Informationen mit angeben damit wir Admidio-Entwickler den Fehler einfacher und schneller finden können.
  
 Zu diesen Informationen gehören (Beispiele): Zu diesen Informationen gehören (Beispiele):
-  * PHP Version (v7.1.2)+  * PHP Version (v8.2.5)
   * Datenbank Typ + Version (MySQL v10.1.2)   * Datenbank Typ + Version (MySQL v10.1.2)
-  * Admidio Version (v3.2.10+  * Admidio Version (v4.2.12
-  * Verwendete Plugins + Versionen (Mitgliedsbeitrag v4.2.1Geburtstagsliste)+  * Verwendete Plugins + Versionen (statistics v3.1.3written communication)
   * Eigene Anpassungen die durchgeführt wurden (anderes Design, eigene Code Änderungen)   * Eigene Anpassungen die durchgeführt wurden (anderes Design, eigene Code Änderungen)
-  * Exception Messages -> Siehe "Debugmodus setzen(auf sensible Informationen achten!) +  * Exception Messages -> Siehe [[de:2.0:probleme_rund_um_admidio#debugmodus_setzen|Debugmodus setzen]] (auf sensible Informationen achten!) 
-  * Logdatei Auszüge -> Siehe "Debugmodus setzen(auf sensible Informationen achten!)+  * Logdatei Auszüge -> Siehe [[de:2.0:probleme_rund_um_admidio#debugmodus_setzen|Debugmodus setzen]] (auf sensible Informationen achten!)
   * Genaue Anleitung der Schritte wie es zum Fehler gekommen ist -> Nicht reproduzierbare Fehler sind sehr schwer zu finden   * Genaue Anleitung der Schritte wie es zum Fehler gekommen ist -> Nicht reproduzierbare Fehler sind sehr schwer zu finden
   * Screenshots wenn sinnvoll   * Screenshots wenn sinnvoll
Line 26: Line 26:
 Nun werden Exceptions und andere schwerwiegende Fehler direkt in der Webseite ausgegeben, sowie erweiterte Informationen in die Logdateien geschrieben. Für jeden Tag wird eine eigene Datei angelegt. Diese könnt ihr mit jedem beliebigen Texteditor öffnen und analysieren. Nun werden Exceptions und andere schwerwiegende Fehler direkt in der Webseite ausgegeben, sowie erweiterte Informationen in die Logdateien geschrieben. Für jeden Tag wird eine eigene Datei angelegt. Diese könnt ihr mit jedem beliebigen Texteditor öffnen und analysieren.
 <file>adm_my_files/logs/admidio-2017-08-23.log</file> <file>adm_my_files/logs/admidio-2017-08-23.log</file>
 +
 +===== PHP-Code in Template-Dateien einbauen =====
 +Admidio nutzt seit Version 4.0 die Template-Engine [[https://www.smarty.net|Smarty]]. Im Theme-Ordner ''adm_themes/simple/templates'' befinden sich die Template-Dateien, welche von euch angepasst werden können um das [[de:2.0:admidio_customization|Layout von Admidio]] euren Wünschen anzupassen.
 +
 +PHP-Code kann man aus Sicherheitsgründen dort nicht einbinden. Wollt ihr dennoch eigenen PHP-Code in einer Template-Datei nutzen, so könnt ihr dies über ein Plugin machen. Erstellt im Ordner ''adm_plugins'' einen neuen Ordner mit einem beliebigen Namen z.B. **skripte**. In diesem Ordner erstellt ihr nun für jeden PHP-Schnipsel den ihr irgendwo einbinden wollt eine eigene Datei z.B. **date.php**. In dieser Datei könnt ihr nun HTML und PHP hinterlegen: <code php><b>Das heutige Datum ist <?php echo date('d.m.Y', time()); ?></b></code> Im nächsten Schritt könnt ihr mit dem folgenden Code die Ausgabe dieser Datei in jeder Template-Datei an einer beliebigen Stelle hinterlegen: <code html>{load_admidio_plugin plugin="skripte" file="date.php"}</code>Dieser Code kann einfach direkt im HTML der Template-Datei abgelegt werden. Dabei wird bei ''plugin="xyz"'' der Name eures Unterordners von adm_plugins angegeben und mit ''file="xyz"'' der Dateiname.
 +
 +===== Probleme beim Fotoupload =====
 +Bei manchen Servern gibt es Probleme beim Fotoupload. Dies kann verschiedene Ursachen haben, die hier nochmal aufgelistet sind:
 +  * Der Ordner **adm_photos** hat nicht die Rechte 777.
 +  * Der Ordner **adm_photos/upload** hat nicht die Rechte 777.
 +  * Die ausgewählten Dateien übersteigen die vom Server bearbeitbare Bildgröße soweit, dass die Maße nicht mehr erfasst werden können und eine entsprechende Fehlermeldung ausgegeben wird. (Die maximal bearbeitbare Bildgröße findet ihr in den **Organisationseinstellungen** unter **Systeminformationen**)
 +  * Manche Server unterbinden den Dateiupload über Flash. Diese Unterbindung lässt sich teilweise umgehen. Legt dazu ein **.htaccess** Datei mit folgendem Inhalt im Admidioverzeichnis ab:<code apache><IfModule mod_security.c>
 +   SecFilterEngine Off
 +   SecFilterScanPOST Off
 +</IfModule></code>
 +  *(Gilt nur für Profilfoto) Manche Datenbanken lassen die Speicherung von Bildern in der Datenbank selbst nicht zu. In diesem Fall könnte ihr Admidio in den **Organisationseinstellungen > Module > Profil > Speicherort der Profilbilder** so umstellen, dass Profilbilder in einem Ordner unter **adm_my_files** gespeichert werden.
  
 ===== Fehler nach Editieren von Dateien ===== ===== Fehler nach Editieren von Dateien =====
Line 40: Line 56:
 Hier ist es ganz einfach, wenn du dich mit der Konsole und dem Editor [[http://www.vim.org|Vim]] auskennst. Öffne die Datei mit Vim und gebe '':set nobomb'' ein. Jetzt die Datei noch Speichern und alles wird gut. Hier ist es ganz einfach, wenn du dich mit der Konsole und dem Editor [[http://www.vim.org|Vim]] auskennst. Öffne die Datei mit Vim und gebe '':set nobomb'' ein. Jetzt die Datei noch Speichern und alles wird gut.
  
-===== Überschriften der Plugins nicht anzeigen ===== +===== Massenzuordnung von Rollen über den Import =====
-Seit Version 2.2 besitzen die meisten Plugins Überschriften, die über dem Plugininhalt angezeigt werden. Sollen diese nicht angezeigt werden, da du selber eine Überschrift auf der Homepage nutzt, oder es einfach nicht in das Layout der Seite passt, so kann man diese Überschriften mit einem einfachen CSS-Schnipsel entfernen. Dazu ergänzt du folgenden Code in der **system.css** in deinem Themeordner im Unterordner **css**: +
-<code css>.admPluginHeader { +
-    display:            none; +
-}</code> +
- +
-===== Massenrollenzuordnung über den Import =====+
 Will man schnell vielen Benutzern eine bestimmte Rolle zuordnen, so kann man dies auch über den Import tätigen. Dazu erstellt man eine Excelliste mit Vorname und Nachname der Personen, die die Rolle zugeordnet bekommen sollen. Ggf. kann man diese Liste über den Export einer anderen Rolle erstellen lassen und verändert diese Liste nur noch.  Will man schnell vielen Benutzern eine bestimmte Rolle zuordnen, so kann man dies auch über den Import tätigen. Dazu erstellt man eine Excelliste mit Vorname und Nachname der Personen, die die Rolle zugeordnet bekommen sollen. Ggf. kann man diese Liste über den Export einer anderen Rolle erstellen lassen und verändert diese Liste nur noch. 
  
 Diese Liste gibt man nun beim Import an und wählt den bei **Existierende Benutzer** den Typ **Ergänzen**. Im nächsten Schritt ordnet man seine Pflichtfelder zu und danach werden die Benutzer importiert und die Rollenzuordnung angelegt. Da die Benutzer bereits alle existieren und auch keine Änderungen an den Feldinhalten vorgenommen wurden, werden so nur die Rollenzuordnung schnell und einfach angelegt. Diese Liste gibt man nun beim Import an und wählt den bei **Existierende Benutzer** den Typ **Ergänzen**. Im nächsten Schritt ordnet man seine Pflichtfelder zu und danach werden die Benutzer importiert und die Rollenzuordnung angelegt. Da die Benutzer bereits alle existieren und auch keine Änderungen an den Feldinhalten vorgenommen wurden, werden so nur die Rollenzuordnung schnell und einfach angelegt.
- 
-===== Grafiken anpassen ===== 
- 
-**Icons**\\  
-Im Ordner Icons des von euch gewählten Themes findet ihr alle Icons die in Admidio verwendet werden. Alle Icons sind entweder 16x16 (z.B.{{:de:2.0:home_small.png|}}) oder 32x32 (z.B.{{:de:2.0:home_big.png|}}) Pixel groß. Solltet ihr die bestehenden Icons ändern wollen, ersetzt einfach die bestehenden Dateien durch eure eigenen. Dabei solltet ihr darauf achten, dass ihr die Größe entsprechend anpasst. Manche Symbole werden in beiden Größen verwendet. Damit eure Nutzer ein einheitliches Bild vorfinden, solltet ihr wenn beide Formate erneuern. 
- 
- 
-**Sonstige verwendete Grafiken**\\  
-Hier werden einige der für das "modern"-Layout verwendeten Grafiken als Photoshop-Rohdaten zur Verfügung gestellt. So lassen sich z.B. die Farben recht einfach anpassen. Noch ein Tipp: Nach den Änderungen das Bild einfach über "Datei > Für Web und Geräte speichern" ins png-Format umwandel und in den richtigen Ordner speichern. 
- 
-**no_profile_pic**\\  
-Diese Grafik wird angezeigt, wenn ein Benutzer kein eigenes Foto in sein Profil geladen hat.[[http://www.admidio.org/daten/no_profile_pic.psd]] 
  
 ===== Admidio-Ordner verschieben ===== ===== Admidio-Ordner verschieben =====
Line 72: Line 70:
  
 Jetzt läuft Admidio in dem neuen Ordner. Jetzt läuft Admidio in dem neuen Ordner.
 +
 +===== Zurück-Link ins Theme einbauen =====
 +Hin und wieder ist es praktisch einen Link zu haben, der einen Zurück zur vorherigen Seite bringt. Wenn ihr diesen Link benötigt, könnt ihr diesen an beliebiger Stelle in der Templatedatei hinterlegen. Öffnet dazu die Datei ''adm_themes/simple/templates/index.tpl'' und fügt dort an der gewünschten Stelle diesen Codeschnipsel ein: <code smarty>{if $hasPreviousUrl}
 +    <!-- Add link to previous page -->
 +    <a id="admidio-back-link" class="" href="{$urlAdmidio}/adm_program/system/back.php"><i class="fas fa-arrow-circle-left fa-fw"></i> {$l10n->get('SYS_BACK')}</a>
 +{/if}</code>Es wird in diesem Fall nur ein Link angezeigt, sofern auch eine sinnvolle URL von einer vorherigen Seite vorhanden ist. Die optische Gestaltung könnt ihr über CSS noch weiter anpassen oder auch in dem Code-Schnipsel das HTML entsprechend abändern.
  • de/2.0/probleme_rund_um_admidio.1503738433.txt.gz
  • Last modified: 2017/08/26 11:07
  • by ximex