Install an Extension
Upload the extension files to your server
Using package download and FTP
- On the extension's page at http://www.getsymphony.com, click the "Download Extension" button.
- Once the file is saved to your computer, extract it.
- Using an FTP client, connect to your server and navigate to your Symphony project's
/extensions
directory. - Upload the extension folder you extracted (see note on naming below)
Using Git
- On the extension's page at http://www.getsymphony.com, click the Repository Link.
- Copy the extension's "Clone URL"
- SSH to your server
cd
to your Symphony project's/extensions
directory.git clone paste-the-clone-url-here
Enable the extension
In your Symphony project's admin interface, navigate to System > Extensions
. Find the extension you'd like to install, and click on it's row in the table—it should turn blue. Using the "With Selected" dropdown at the bottom right, choose "Enable" and hit "Apply."
A Note About Extension Names
Symphony has a strict naming convention—the name of the extension directory must match the name of the class in its driver file.
Most of the time, you won't have to worry, developer's are savvy enough to make sure everything's labeled properly. But sometimes the name of the directory will be altered (Github, for example, adds the username and commit ID to Zip/Tar downloads). If you experience problems installing an extension, checking the directory name is a good place to start.
Here's an example. For the Maintenance Mode extension, the class declaration looks like this:
Class extension_maintenance_mode
So that extension's directory must be named:
maintenance_mode