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 [2026/01/11 11:27] – fasseen:plugins:installation [2026/01/24 12:13] (current) – fasse
Line 1: Line 1:
 ====== Using  Plugins in your homepage ====== ====== Using  Plugins in your homepage ======
-===== The difference between Plugins and Modules=====+===== Which plugins can I install on other websites? =====
  
-Plugins are small PHP scripts doing defined works  (e.g. show the events of the next 2 days, show actual birthdays...). Unlike modules, plugins must be called not necessarily as a separate page, but can be integrated into any html or php page. You can download the plugins in the body_top.php or body_bottom.php installed by Admidio so that certain information is displayed on all pages Admidio.+Would you like to display specific information from Admidio on your club website or elsewhere? You can use the plugins on the Admidio overview page to do this. There is a plugin for almost every module here, which can also be customized individually. Here you can display the next two events or current birthdays, for example. Unlike modules, these overview plugins do not necessarily have to be called up as a separate page, but can be integrated into other websites as HTML snippets.
  
 +===== How do I integrate plugins? ===== 
 +The corresponding plugin should already be set up in the **adm_plugins** folder.
  
- +==== Add plugin to the Admidio overview ====
-===== How do I install plugins? =====  +
-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 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 44: Line 42:
 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 plugins outside of an Admidio page ====+==== Integrating plugins outside of Admidio pages ==== 
 + 
 +You can usually also use the plugins outside of Admidio pages and integrate them into your own HTML/PHP pages. However, this requires a few additional steps. 
 + 
 +=== Integrating the plugin as an iFrame === 
 + 
 +The simplest and recommended way to integrate plugins from the overview page into another website is to integrate them as an iFrame into the HTML code of the other website. To do this, you can place the following HTML code exactly where you want the plugin to appear: 
 +<code html><iframe src="#URL-to-Admidio#/adm_plugins/#Folder-of-the-specific-plugin#/#Start-file-of-the-plugin"#></iframe></code> 
 +The specific implementation for the login plugin would then look like this if Admidio is installed in the **admidio** subfolder in your web space: 
 +<code html><iframe src="admidio/adm_plugins/login_form/index.php"></iframe></code> 
 +You can then easily define the size, borders, and spacing of the plugin for CSS, which could look like this: 
 +<code css>iframe { 
 +   width: 80%; 
 +   height: 600px; 
 +   border: 1px solid #ccc; 
 +}</code> 
 +Now you can reload your website and the corresponding plugin will be displayed :-) 
 +\\ \\  
 + 
 +=== Embed plugin as code block in website ===
  
 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.
Line 53: Line 70:
  
 <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 65: Line 82:
      
   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 75: Line 92:
      
   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 86: Line 103:
  
 <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 100: Line 117:
 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. 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: +You can see an example of integrating a plugin into a website using iFrame in the highlighted area of this screenshot:\\  
-{{:de:2.0:documentation:plugins:plugins_show.png?400|Install plugins}}+{{:en:plugins:plugin_integration_en.png?300|Integrating plugins via iFrame}} 
 + 
 +You can see an example of plugin integration on the overview page in this screenshot:\\  
 +{{:en:plugins:plugin_overview_en.png?400|Integrate plugins into overview page}}
  
 ===== How do I update a plugin?===== ===== How do I update a plugin?=====
 If there is an update, because of a bug fix, a new feature, or due to an incompatibility with current Admidio version, you can replace the plugin folder. Download the latest version from [[en:plugins:index|Plugin Area]]  and replace the existing plugin folder with the new folder of the downloaded zip-file. Special features of the update are mentioned in the **readme.txt**  in the plugin folder. If there is an update, because of a bug fix, a new feature, or due to an incompatibility with current Admidio version, you can replace the plugin folder. Download the latest version from [[en:plugins:index|Plugin Area]]  and replace the existing plugin folder with the new folder of the downloaded zip-file. Special features of the update are mentioned in the **readme.txt**  in the plugin folder.
  
  • en/plugins/installation.1768127263.txt.gz
  • Last modified: 2026/01/11 11:27
  • by fasse