Merge pull request docker-library#882 from TimWolla/adminer-4.3.1

Update adminer/content.md
classicvalues · Apr 19, 2017 · cbbe664 · cbbe664
2 parents 5b368d8 + cbc337f
commit cbbe664
Showing 1 changed file with 38 additions and 0 deletions.
diff --git a/adminer/content.md b/adminer/content.md
@@ -26,6 +26,44 @@ Then point your web server to port 9000 of the container.
 
 Note: This exposes the FastCGI socket to the Internet. Make sure to add proper firewall rules or use a private Docker network instead to prevent a direct access.
 
+### Loading plugins
+
+This image bundles all official adminer plugins. You can find the list of plugins on GitHub: https://github.com/vrana/adminer/tree/master/plugins.
+
+To load plugins you can pass a list of filenames in `ADMINER_PLUGINS`:
+
+	$ docker run --link some_database:db -p 8080:8080 -e ADMINER_PLUGINS='tables-filter tinymce' adminer
+
+If a plugin *requires* parameters to work correctly you will need to add a custom file to the container:
+
+	$ docker run --link some_database:db -p 8080:8080 -e ADMINER_PLUGINS='login-servers' adminer
+	Unable to load plugin file "login-servers", because it has required parameters: servers
+	Create a file "/var/www/html/plugins-enabled/login-servers.php" with the following contents to load the plugin:
+
+	<?php
+	require_once('plugins/login-servers.php');
+
+	/** Set supported servers
+	    * @param array array($domain) or array($domain => $description) or array($category => array())
+	    * @param string
+	    */
+	return new AdminerLoginServers(
+	    $servers = ???,
+	    $driver = 'server'
+	);
+
+To load a custom plugin you can add PHP scripts that return the instance of the plugin object to `/var/www/html/plugins-enabled/`.
+
+### Choosing a design
+
+The image bundles all the designs that are available in the source package of adminer. You can find the list of designs on GitHub: https://github.com/vrana/adminer/tree/master/designs.
+
+To use a bundled design you can pass its name in `ADMINER_DESIGN`:
+
+	$ docker run --link some_database:db -p 8080:8080 -e ADMINER_DESIGN='nette' adminer
+
+To use a custom design you can add a file called `/var/www/html/adminer.css`.
+
 ## Supported Drivers
 
 While Adminer supports a wide range of database drivers this image only supports the following out of the box: