1   Symfony Framework

Asterisell uses the Symfony PHP framework wich is a well documented and designed framework.

1.1   Installation

Asterisell distribution contanins a “snapshot” of the Symfony framework.

If you want to use the most recent version of Symfony framework you can install it through the PEAR PHP Extension and Application Repository

pear channel-discover pear.symfony-project.com
pear install symfony/symfony

In order to upgrade to new versions of symfony:

pear upgrade symfony/symfony

Do not forget to clear the Asterisell cache executing in the Asterisell directory:

symfony cc

1.1.1   Patch Application

Up to date a patched version of Symfony 1.0.5 is used, so you must apply the patch inside the directory “symfony-patch”.

Consult the README file for details on how to apply the patch.

2   Asterisell Development Version Usage

If you run Asterisell in production mode every time you change some code you must rexecute the command

symfony cc

because the page generation result is cached for performance reasons.

If you run Asterisell in development mode all the pages are regenerated every time.

In order to enable the development mode execute

symfony enable asterisell dev

If Asterisell project is in the ”/var/www/asterisell” directory and your local apache server is listening on port 3000, then you must open the web page:

http://localhost:3000/asterisell/web/asterisell_dev.php/login

3   Asterisell Localization

If you want to support a new language / culture you must:

• add to “apps/asterisell/config/app.yml” the new currency and culture;
• copy “apps/asterisell/i18n/messages.it.xml” to “apps/asterisell/i18n/messages.your_culture_code.xml”;
• replace all Italian translations with your locale translations;
• update “apps/asterisell/lib/standardMailWithInvoiceGenerator.class.php” with the new culture support;
• execute ”./symfony cc” in order to clear the cache and view the new messages;
• make a login in Asterisell web interface using a web account with the new culture in order to inspect the result;