Extensions
SimpleID has the ability to support "extensions". Extensions are PHP files containing code which extends the functionality of SimpleID. The code within extensions follow a set of conventions which allows SimpleID to call them during key parts of the OpenID authentication process.
The main purpose of SimpleID extensions is to provide a way in which to implement OpenID extensions. However, the system is flexible enough for SimpleID extensions to function in other ways.
Extensions are named name.extension.php
, where name is the name of the extension. Each extension resides in its own directory underneath the extensions
subdirectory of the SimpleID web directory (www
).
If you want to write your own extensions, see the developer web site.
Installing and uninstalling extensions
Installing an extension
To install an extension:
-
If the extension is not included in the default SimpleID distribution:
-
Extract the archive containing the extension into a temporary directory
-
Move the contents of the
www
directory (including any subdirectories) into the web directory.
-
-
To enable the extension, edit the
SIMPLEID_EXTENSIONS
configuration option in theconfig.php
file and add the name of the extension. Separate multiple extensions with commas.
If the version of SimpleID you originally installed was before 0.5, the SIMPLEID_EXTENSIONS
configuration option may not exist in your config.inc
file. You can add it in manually.
Uninstalling an extension
To uninstall an extension
-
Edit the
SIMPLEID_EXTENSIONS
configuration option in theconfig.php
file and delete the name of the extension. -
You can also delete the extension file from the web directory. This is an optional process.