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
en:plugins:installation [2021/01/04 07:59] – [How do I update a plugin?] fasseen:plugins:installation [2026/01/11 11:50] (current) – fasse
Line 9: Line 9:
 Download the plugin from [[en:plugins | our plugin area]] and unpack the zip file. Copy the folder with the files in the folder ** adm_plugins ** in your Admidio folder.  If the folder adm_plugins  does not exist, it must first be created yet. This should be on the same level as adm_my_files. Download the plugin from [[en:plugins | our plugin area]] and unpack the zip file. Copy the folder with the files in the folder ** adm_plugins ** in your Admidio folder.  If the folder adm_plugins  does not exist, it must first be created yet. This should be on the same level as adm_my_files.
  
-==== Install plugin into an Admidio 4 page ====+==== Install plugin into an Admidio page ====
  
 Check the installation instructions on the plugin page in the first step. Some Plugins supply their own installation script and integrate themselves thereby independently into our menu. In this case no further steps are necessary. Check the installation instructions on the plugin page in the first step. Some Plugins supply their own installation script and integrate themselves thereby independently into our menu. In this case no further steps are necessary.
Line 16: Line 16:
  
 Several DIV blocks are stored there and you have to add your new DIV block behind an existing DIV block. The DIV-blocks look like this:  Several DIV blocks are stored there and you have to add your new DIV block behind an existing DIV block. The DIV-blocks look like this: 
 +<code html><div class="admidio-overview-plugin col-sm-6 col-lg-4 col-xl-3" id="admidio-plugin-name">
 +   <div class="card admidio-card">
 +      <div class="card-body">
 +         {load_admidio_plugin plugin="plugin-name" file="plugin-file-name"}
 +      </div>
 +   </div>
 +</div></code>
 +
 <code html><div class="col-sm-6 col-lg-4 col-xl-3"> <code html><div class="col-sm-6 col-lg-4 col-xl-3">
     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">     <div class="card admidio-roles" id="role_details_panel_'.$rolId.'">
Line 26: Line 34:
  
 If you want to include for example the Plugin ''adm_plugins/calendar/calendar.php'', then the code block looks afterwards like this  If you want to include for example the Plugin ''adm_plugins/calendar/calendar.php'', then the code block looks afterwards like this 
-<code html><div class="col-sm-6 col-lg-4 col-xl-3"> +<code html><div class="admidio-overview-plugin col-sm-6 col-lg-4 col-xl-3" id="admidio-plugin-calendar"> 
-    <div class="card admidio-roles" id="role_details_panel_'.$rolId.'"> +   <div class="card admidio-card"> 
-        <div class="card-body" id="admRoleDetails'.$rolId.'"> +      <div class="card-body"> 
-            {load_admidio_plugin plugin="calendar" file="calendar.php"} +         {load_admidio_plugin plugin="calendar" file="index.php"} 
-        </div> +      </div> 
-    </div>+   </div>
 </div></code> </div></code>
  
 Then you can reload the overview page and your plugin should be visible. Then you can reload the overview page and your plugin should be visible.
- 
-==== Install plugin into an Admidio 3 page ==== 
- 
-The installation of a plugin within an Admidio page is really simple. Go to the file **adm_themes/modern/my_body_bottom.php** and add at the corresponding place the following code: 
-<code php><?php include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php'); ?></code> 
-If you are within a PHP part of your page than you must only add: 
-<code php>include(ADMIDIO_PATH . FOLDER_PLUGINS . '/birthday/birthday.php');</code> 
- 
-Now reload the Admidio page and the plugin should be shown.\\   
-Since version 3.0 all css files of the plugins will be loaded automatically and must not be added separatly. 
  
 ==== Install plugins outside of an Admidio page ==== ==== Install plugins outside of an Admidio page ====
Line 50: Line 48:
 You can also use the plugins outside of the Admidio pages and integrate them into your own HTML / PHP pages. However, a few additional steps are necessary. You can also use the plugins outside of the Admidio pages and integrate them into your own HTML / PHP pages. However, a few additional steps are necessary.
  
-If you want to integrate the plugin into a pure html page, you should first rename the file extension of the page from html to php. Now you can integrate the plugin with help from PHP into your formerly pure HTML page. Now add the plugins // (as an example here the plugin login_form) // into your Html code at the point where the output of the plugin should be displayed by one of the following methods:+If you want to integrate the plugin into a pure html page, you should first rename the file extension of the page from html to php. Now you can integrate the plugin with help from PHP into your formerly pure HTML page. Now add the plugins (as an example here the plugin //login_form//) into your Html code at the point where the output of the plugin should be displayed by one of the following methods:
  
 1. First the file //common.php// must be added **at the very beginning** of your PHP file via the server path: 1. First the file //common.php// must be added **at the very beginning** of your PHP file via the server path:
  
 <code php><?php <code php><?php
-  include_once($_SERVER['DOCUMENT_ROOT']. '/Path-to-Admidio-folder /adm_program/system/common.php');+  include_once($_SERVER['DOCUMENT_ROOT']. '/Path-to-Admidio-folder /system/common.php');
 ?></code> ?></code>
 The //Path-to-Admidio-folder// must contain the folder structure, which you have to go from the file in which you want to install the plugin, to the Admidio folder. The //Path-to-Admidio-folder// must contain the folder structure, which you have to go from the file in which you want to install the plugin, to the Admidio folder.
Line 67: Line 65:
      
   Include-Befehl:   Include-Befehl:
-  include_once($_SERVER['DOCUMENT_ROOT']. '/admidio/adm_program/system/common.php');+  include_once($_SERVER['DOCUMENT_ROOT']. '/admidio/system/common.php');
  
 **Example 2** **Example 2**
Line 77: Line 75:
      
   Include-Befehl:   Include-Befehl:
-  include_once($_SERVER['DOCUMENT_ROOT']. '/../admidio/adm_program/system/common.php');+  include_once($_SERVER['DOCUMENT_ROOT']. '/../admidio/system/common.php');
      
 2. Afterwards the plugins are installed in the desired places: 2. Afterwards the plugins are installed in the desired places:
  
 <code php><?php <code php><?php
-  include($_SERVER['DOCUMENT_ROOT']. '/Path-to-Admidio-folder /adm_plugins/login_form/login_form.php');+  include($_SERVER['DOCUMENT_ROOT']. '/Path-to-Admidio-folder /adm_plugins/login_form/index.php');
 ?></code> ?></code>
  
Line 88: Line 86:
  
 <code php><?php <code php><?php
-  include('http://www.example.org/Path-to-Admidio-folder /adm_plugins/login_form/login_form.php');+  include('http://www.example.org/Path-to-Admidio-folder /adm_plugins/login_form/index.php');
 ?></code> ?></code>
  
Line 96: Line 94:
  
 ===== Where can I configure the plugins?===== ===== Where can I configure the plugins?=====
-You can configure most plugins via **config.php** file that is located in the same folder as the plugin. Here are some variables with default values available. This you can customize according to your needs. +You can configure most plugins via a **config.php** file. For this purpose, a **config_sample.php** file is usually delivered, which should be located in the folder of the plugin. You can simply rename this file to **config.php**. Here are some variables with default values available. You can change them according to your needs.  
-Does the plugin have a CSS file, it can be customized using the the layout of the plugin. + 
-Updating a plugin, these 2 files should not been necessarily overwritten. In case new settings or CSS settings are added by the update, then the new variable or CSS settings should be copied from the downloaded files into the existing files //(config.php and pluginname.css)// of the plugin and the desired values can be customized .+If the plugin has its own CSS file, the layout of the plugin can be adjusted via this file.  
 + 
 +When updating the plugin, these two files need not and should not be overwritten. If new settings or CSS settings are added by the update, the new variables or CSS settings can be copied from the **config_sample.php** into the previous files //(config.php and pluginname.css)// of the plugin and the desired values can be inserted.
  
 An example of integration of multiple plugins in a sidebar you can see on this screenshot in the highlighted area: An example of integration of multiple plugins in a sidebar you can see on this screenshot in the highlighted area:
  • en/plugins/installation.1609743547.txt.gz
  • Last modified: 2021/01/04 07:59
  • by fasse