Differences

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

--- en:2.0:probleme_rund_um_admidio [2015/11/23 21:19] – [Move Admidio folder] fasse
+++ en:2.0:probleme_rund_um_admidio [2024/11/29 17:23] (current) – [Mass assignment of roles using the import] greno
@@ Line 1: / Line 1: @@
 ====== Tips and tricks ======
+===== Helpful information in case of problems =====
+If Admidio does not work the way you want it and you're looking for help in the forum etc, please always provide some additional information so we Admidio developers can find the bugs faster and easier.
+This information includes (Examples):
+  * PHP version (v8.2.5)
+  * Database type + version (MySQL v10.1.2)
+  * Admidio version (v4.2.12)
+  * Used Plugins + versions (statistics v3.1.2, written communication)
+  * Own adjustments were made (different design, own code changes)
+  * Exception Messages -> View [[en:2.0:probleme_rund_um_admidio#set_debug_mode|Set debug mode]] (Pay attention to sensitive information!)
+  * Logdatei Auszüge -> View [[en:2.0:probleme_rund_um_admidio#set_debug_mode|Set debug mode]] (Pay attention to sensitive information!)
+  * Detailed instructions on how to make the mistake -> Non-reproducible errors are very hard to find
+  * Screenshots if useful
+  * If error after update -> Check if everything has been updated (Plugins, Libs, Theme, ...)
+===== Set debug mode =====
+Even Admidio is not free from problems or bugs. Should you ever have a problem, you can turn on the debug mode for a better analysis. In this mode, every command sent to the database is recorded. In addition, many more informations are logged at every page view. All this will then be saved in a log file.
+Please use this mode only if we ask you in the forum or if you can handle the information from the log file. The debug mode should only be used for a limited time in the production system.
+You can turn on the debug mode in the **config.php** by adding the following line if it does not already exist:
+<code php>$gDebug = 1;</code>
+Now, exceptions and other fatal errors are shown directly to the web page, as well as extended information written to the log files. For each day a separate file is created. You can open and analyze these with any text editor.
+<file>adm_my_files/logs/admidio-2017-08-23.log</file>
+===== Include PHP code in template files =====
+Admidio uses the template engine [[https://www.smarty.net|Smarty]] since version 4.0. In the theme folder ''adm_themes/simple/templates'' you can find the template files, which can be customized by you to adapt the [[en:2.0:admidio_customization|layout of Admidio]] to your wishes.
+PHP code cannot be included there for security reasons. If you still want to use your own PHP code in a template file, you can do this via a plugin. Create a new folder in the folder ''adm_plugins'' with a name of your choice, e.g. **scripts**. In this folder you create a new file for every PHP snippet you want to include e.g. **date.php**. In this file you can now store HTML and PHP: <code php><b>The current date is <?php echo date('d.m.Y', time()); ?></b></code> In the next step, you can use the following code to place the output of this file anywhere in any template file: <code html>{load_admidio_plugin plugin="scripts" file="date.php"}</code>This code can simply be placed directly in the HTML of the template file. With ''plugin="xyz"'' the name of your subfolder of adm_plugins is specified and with ''file="xyz"'' the filename.
+===== Problems in Photo Upload =====
+Some servers have problems uploading photos. This can have various causes, which are listed here:
+  * Folder **adm_photos** does not have the rights 777.
+  * Folder **adm_photos/upload** does not have the rights 777.
+  * The selected files exceed the editable image size from the server so that the dimensons can no longer be detected and an appropriate error message is issued. (The maximum editable image size can be found in the organization **Settings** under **Information System**)
+  * Some servers prohibit the upload file on Flash. This inhibit can partly be evaded. Define a **.htaccess** file with the following content in the root where Admidio is installed with the following content:<code apache><IfModule mod_security.c>
+   SecFilterEngine Off
+   SecFilterScanPOST Off
+</IfModule></code>
+  *(Applies only to profile photo) Some databases do not allow the storage of images in the database itself. In this case, you could Admidio switch the location of profile images in  **organizational settings > Profile> location of profile images** so the profile pictures are stored in the folder **adm_my_files**.
 ===== Error after editing files =====
@@ Line 14: / Line 56: @@
 Here it is quite easy if you know the console and the editor [[http://www.vim.org|Vim]] . Open the file with Vim and enter '': set nobomb ''. Now save the file, and everything will be fine.
-===== Not view topics of plugins =====
+===== Mass assignment of roles using the import =====
-Since version 2.2 that most plugins headings that appear above the plug-in content. If these shall not be displayed, because you want to use an own headine on your homepage, or it just does not fit into the layout of the page, so you can remove these headers with a simple CSS snippets. For this you add the following code in the **system.css** in your theme folder in the subfolder **css**:
-<code css>.admPluginHeader {
-    display:            none;
-}</code>
-===== Mass role assignment using the import =====
 If you want to quickly assign multiple users in a specific role, so you can make this even with the import function. For this purpose, you create an Excel list with first name and surname of the person that should get assigned to the role. If necessary, you can export a list from a different role and do your adjustments there.
-This spreadsheet you now choose for the import with selection  **Existing users** type **complete**. In the next step you assign the mandatories, then the users are imported and the role assignment are created. Due to users were already added and also no changes in field contents are made so far, the role assignments are created quickly and easily.
+This spreadsheet you now choose for the import with selection  **Existing contacts** type **Complement**. In the next step you assign the mandatories, then the users are imported and the role assignment are created. Due to users were already added and also no changes in field contents are made so far, the role assignments are created quickly and easily.
-===== Modify graphics =====
-**Icons**\\
-In the folder icons of the selected Theme you can find all the icons that are used in Admidio. All icons are either 16x16 (eg {{:de:2.0:home_small.png |}}) or 32x32 (eg {{:de:2.0:home_big.png|}}) pixels in size. Should you want to change the existing icons, simply replace the existing files with your own. Here you should make sure that you adjust the size accordingly. Some symbols are used in both sizes. To help your users to find a uniform image,  you should renew both formats.
-**Other used graphics**\\
-Some of the graphics used for the "modern" layout are provided as Photoshop raw data. Thus, for example, the colors quite easy can be adapted. Another tip: After the changes use  "File> Save for Web & Devices" to simply convert to PNG and save it in the correct folder.
-**no_profile_pic**\\
-This graphic is displayed when a user has uploaded no own avatar to the profile.[[http://www.admidio.org/daten/no_profile_pic.psd]]
 ===== Move Admidio folder =====
@@ Line 46: / Line 70: @@
 Now Admidio is running in the new folder.
+===== Insert back link into theme =====
+From time to time it is useful to have a link that takes you back to the previous page. If you need this link, you can place it anywhere in the template file. Open the file ''adm_themes/simple/templates/index.tpl'' and insert the following code snippet at the desired place:<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>In this case, only the link will be displayed if there is also a meaningful URL from a previous page. You can further adjust the visual design via CSS or change the HTML in the code snippet accordingly.