Note: Pompodium is no longer in active development. This is the archived version from 2013

Six years ago, we set out to create a magazine. What started as an idea to create a platform for photos and articles on typography and design, travel and life finally found it’s destination: this is Pompodium, an ensemble for Symphony.

After months spent thinking, talking, brainstorming, scribbling, designing, pushing pixels, writing code, being overtaken with new ideas and starting all over again for about three times, the nearly finished website sat untouched for one year. Patiently awaiting its future destiny, the mention of the first Symposium 2010 in London finally caused an epiphany to release Pompodium as a magazine-style ensemble for this occasion. Hooray!

Today, three years after its first release, we finally updated Pompodium to the latest Symphony version, everything is freshened up and ready to play: we simplified the backend structure, made the layout adapt to the screen responsively and made use of modern technology. Using SVG images where needed and webfonts all over, this ensemble is ready for retina displays as well.

Pompodium is available on Github and can be evaluated and used for free. As soon as you want to use Pompodium in production, you must purchase a licence. A licence is 25 € (excluding taxes) and valid for a single website. Send us an email for inquiries or further questions!

• Version: 2.3.3
• Date: 12th July 2013
• Release Notes: http://getsymphony.com/download/releases/version/2.3.3/
• Github Repository: http://github.com/symphonycms/symphony-2/tree/2.3.3

• Overview
• Server requirements
• Installing
  • Via Git
  • Via the old-fashioned way
  • File permissions
• Updating from an older version
  • Version-specific notes
  • Updating via Git
  • Updating via the old-fashioned way

Symphony is a PHP & MySQL based CMS that utilises XML and XSLT as its core technologies. This repository represents version 2.3.3 and is considered stable.

Visit the Symphony website, the forum or learn how you can contribute to Symphony.

• PHP 5.2 or above (PHP 5.3 recommended)
• PHP’s LibXML module, with the XSLT extension enabled (--with-xsl)
• MySQL 5.0 or above
• A webserver (known to be used with Apache, Litespeed, Nginx and Hiawatha)
• Apache’s mod_rewrite module or equivalent
• PHP’s built in json functions, which are enabled by default in PHP 5.2 and above; if they are missing, ensure PHP wasn’t compiled with --disable-json

While Windows is not officially supported for production, we understand many developers use WAMP for Symphony development before deploying to a production server. The Symphony team recommends that while using WAMP, developers use the latest PHP 5.3.x version during development to minimise any potential issues. PHP 5.3 provides numerous fixes and improvements to help minimise and standardise the result of several functions that behave slightly differently depending on the OS.

Before installation, see the notes on file permissions.

1. Clone the git repository to the location you desire using:

    git clone git://github.com/symphonycms/symphony-2.git
   

   The following repositories are included as submodules:

   Markdown
   Maintenance Mode
   Select Box Link Field
   JIT Image Manipulation
   Export Ensemble
   Debug DevKit
   Profile DevKit
   XSS Filter

2. Run the following command to ensure the submodules are cloned:

    git submodule update --init --recursive
   

3. (Optional) If you would like the default ensemble installed as well, you will need to use the following command from within the Symphony 2 folder you just created:

    git clone git://github.com/symphonycms/workspace.git
   

4. Point your web browser at http://example.com/install/ and provide details for establishing a database connection and about your server environment.

5. Chuckle villainously and tap your fingertips together (or pet a cat) as your installation completes.

6. Remove installer files:

   rm -rf install/ workspace/install.sql

Note: You can leave /workspace out if you do not want the default theme.

1. This step assumes you downloaded a zip archive from the Symphony website. Upload the following files and directories to the root directory of your website:

   index.php
/install
/symphony
/workspace
/extensions

2. Point your web browser at http://example.com/install/ and provide details on establishing a database connection and your server environment.

3. Pose like you’re being filmed for a dramatic close-up while your installation completes.

4. Remove installer files:

   rm -rf install/ workspace/install.sql

1. Symphony’s installer will inform you if it needs write access to files that it doesn’t already have, but you can ensure it has the access it needs by temporarily setting files to world-writeable.

   cd /your/site/root
chmod -R 777 .

2. Once Symphony is successfully installed, you should change file permissions to something tighter for security reasons. Symphony recommends 755 for directories and 644 for files as a good default, but this may need to be changed depending on your server’s users and groups configuration. For example, you may need to change directories and files that Symphony needs to subsequently write to to 775 and 664 respectively.

You may find these commands useful when adjusting file and directory permissions.

To recursively chmod directories only:

find /your/site/root -type d -exec chmod 755 {} \;

To recursively chmod files only:

find /your/site/root -type f -exec chmod 644 {} \;

Symphony 2.3 officially only supports updating from a 2.2.x release. There are various changes between 2.1 and 2.3 that make this update unlikely to be successful. Symphony 2.3 also enforces that all authors have unique email addresses, so please ensure that this constraint is met before updating.

Symphony 2.2 introduces numerous improvements that may affect extension compatibility. Before updating, be sure to consult the extension compatibility table to verify that the extensions you’re using have all been updated for Symphony 2.2.

As of version 2.1, Symphony stores passwords using the more secure SHA1 algorithm (previous versions used MD5). When updating to 2.1, the primary user’s login password will be reset (the new password will be displayed by the updater—please note it).

Please also note that all other users’ passwords will no longer be valid and will require a manual reset through Symphony’s forgotten password feature. Alternatively, as an administrator, you can also change your users’ passwords on their behalf.

We are now using GitHub’s organisations feature. As a result, all submodules—as well as the main Symphony 2 repo—are forks owned by the Symphony CMS organisation.

To fully update your Git-based installation, please edit your .git/config and the .git/config of each core extension (debugdevkit, profiledevkit, markdown, maintenance_mode, selectbox_link_field, jit_image_manipulation and export_ensemble) and change the URL of the remote repo from symphony or pointybeard to be symphonycms.

For example:

[remote "origin"]
	fetch = +refs/heads/*:refs/remotes/origin/*
	url = git://github.com/pointybeard/markdown.git

Change git://github.com/pointybeard/markdown.git to git://github.com/symphonycms/markdown.git

Version 2.0.5 introduced multiple includable elements in the Data Source Editor for a single field. After updating from 2.0.5 or lower, the DS editor will seem to “forget” about any Textarea fields selected when you are editing existing Data Sources. After updating, you must ensure you re-select them before saving. Note, this will only effect Data Sources that you edit and were created prior to 2.0.5. Until that point, the field will still be included in any front-end XML.

1. Pull from the master branch at git://github.com/symphonycms/symphony-2.git

2. Use the following command to bring extensions up to date:

    git submodule update --init --recursive
   

3. If updating from a version older than 2.0.5, enable the Debug DevKit and Profile DevKit extensions.

4. Go to http://example.com/install/ to complete the update process.

5. You and your website are now in the future. Buy yourself a silver jumpsuit.

Follow the instructions below if you are updating from Symphony 2.0 (not from Git)

Note: As of 2.0.6, there is no longer a need to backup /symphony/.htaccess.

1. Upload /symphony, /install & index.php, replacing what is already on your server.

2. If you are updating from a version older than 2.0.5, download and install the Debug DevKit and Profile DevKit:

   Debug DevKit
   Profile DevKit

3. Go to http://example.com/install/ to complete the update process.

4. Call a friend and brag that your copy of Symphony is newer than theirs.