Alright, SilverStripe again, still our CMS of choice.
Today i’d like to promote a very helpful module that provides Register and Profile Pages for Members for the Frontend.
The memberprofiles module.
It comes with a lot of features and customize options for nearly everthing you might need for Frontend Member Handling.
Further it is fully extendible to customize it even more.

For a starter tutorial i recommend a very good post by deadlytechnology.
I would like to describe how you extend it.

First lets install it (with the orderable module dependency):

cd my_silverstripe_project
git clone https://github.com/ajshort/silverstripe-orderable.git
mv silverstripe-orderable/ orderable
git clone http://github.com/ajshort/silverstripe-memberprofiles.git
mv silverstripe-memberprofiles/ memberprofiles

Run /dev/build?flush=all

At this point i like to skip the further setup, for this, go read the post recommended above.

So now lets extend f.e. the Register Page for the Member to provide a custom template for a custom member, say: Customer, and some additional logic.

Just make a new file mysite/code/CustomerRegisterPage.php:

class CustomerRegisterPage extends MemberProfilePage {
 ...
}

class CustomerRegisterPage_Controller extends MemberProfilePage_Controller {
 ...
}

and a template: themes/mytheme/CustomerRegisterPage.ss
In this template you can now add your markup and include the MemberProfileForm via $RegisterForm.
Or make your own Form by overwriting the RegisterForm in the Controller or make a complete new Form.

To register the template with the extended Page we have to overwrite the index method in the controller.

public function index() {
        if (isset($_GET['BackURL'])) {
            Session::set('MemberProfile.REDIRECT', $_GET['BackURL']);
        }
        return $this->renderWith(array('CustomerRegisterPage', 'Page'));
}

Now we overwrite the register method to add some additional logic, f.e. to add a custom DataObject from a many_many relation from the customer Member.

public function register($data, Form $form) {
        if ($member = $this->addMember($form)) {
            if (isset($data['OptionsID'])) {
                foreach ($data['OptionsID'] as $key => $value) {
                    $member->Options()->setByIDList($data['OptionsID']);
                }
            }
            return $this->redirect($this->Link('afterregistration'));
        } else {
            return $this->redirectBack();
        }
}

Thats it!
Now create a new CustomerRegisterPage in the backend and do as you learned from deadlytechnology.

This is a small shell script to set up silverstripe CMS
along with some modules i often use (as seen in ivo’s post)

The script has two parameters:
- the folder to clone the whole thing into
- the branch/tag to checkout afterwards

# install silverstripe + common modules from github
# usage sh install_silverstripe.sh <folder_name> <tag/branch>
# examples:
# sh install_silverstripe.sh some_folder tags/2.4.5
# sh install_silverstripe.sh some_folder master

As Silverstripe itself is split up in 3 repositories
(the installer/base folder, the cms and the sapphire framework itself)
we fetch the base folder first:

#set up project base folder
git clone git@github.com:silverstripe/silverstripe-installer.git $1
cd $1
git checkout $2

Get the cms

#setup cms
git clone git@github.com:silverstripe/silverstripe-cms.git cms
cd cms
git checkout $2
cd ..

Get sapphire …

#setup framework
git clone git@github.com:silverstripe/sapphire.git sapphire
cd sapphire
git checkout $2
cd ..

Setup some permissions for the web installer.

#set permissions for install
chmod 0777 assets assets/*
chmod 0666 .htaccess mysite/_config.php assets/*/*

Fetch the blackcandy theme from a fourth repository.
Backup the tutorial theme in case we need it.

#install blackcandy theme
mv themes/tutorial ./
rm -rf themes
git clone https://github.com/silverstripe-themes/silverstripe-blackcandy.git themes
cd themes
git checkout $2
cd ..
mv tutorial themes

Install some modules

# install common modules
git clone https://github.com/unclecheese/Uploadify.git uploadify
git clone https://github.com/unclecheese/DataObjectManager.git dataobject_manager
git clone https://github.com/silverstripe/silverstripe-userforms.git userforms

iIput the script on github
…in case you might wanna use it or add something i’ve missed.

Theres a lot of old, deprecated and now wrong installation guides for the SilverStripe Image Gallery Module on the web that will lead you to where you dont want to. Dont trust them!

Unclecheese made some changes to the module dependencies and also moved to git, some time ago. He now uses the new Uploadify module instead of the SwfFileUpload module.

So a working installation of the image-gallery for git-people is to:

install silverstripe 2.4.* (latest)

get the modules via git:

cd mysproject
git clone https://github.com/unclecheese/ImageGallery.git image_gallery
git clone https://github.com/unclecheese/Uploadify.git uploadify
git clone https://github.com/unclecheese/DataObjectManager.git dataobject_manager

login as admin
run:

http://project.local/dev/build?flush=1

Done!

Wie im SilverStripe Blog gelesen kann man die Entwicklung der neuen SilverStripe 3 UI auf github verfolgen.

Außerdem gibts hier ein Interview mit dem Hauptdesigner.

… und wenn man möchte kann man in der Google Group seine Vorschläge loswerden.

Ganz interessante Einblicke, wie ich finde.

Heute möchte ich mal ein Silverstripe Modul von mir vorstellen: silverstripe-i18n-fieldtypes
Es ist eigentlich eher ein Work-around für fehlenden oder ungenügenden I18n Support in sapphire.
Eigentlich sind wir hier alle Fans von Silverstripe, da es für Coder einfach anzupassen ist, aber
speziell beim Umgang mit Datums und Currency Typen in Silverstripe merkt man, dass da noch was fehlt.
Es kann gut sein, dass die nächste Version von sapphire das Modul obsolet machen -ich hoffe es sogar-
aber bis dahin, soll dieses Modul helfen.

Für Datum Werte mit deutscher Formatierung muss man zB überall in den templates folgendes machen

$Datetime.FormatI18N(%e. %B %G).

Es reicht nicht einfach sowas in der config anzugeben:

i18n::set_locale('de_DE');

Und das ist schon ganz schön nervig.
Aber hier hilft dann das Modul.

Sapphire kennt verschiedene Wege zur Formatierung, die in Zukunft wahrscheinlich noch vereinheitlicht werden.
Im Groben sind das:

• - PHP setlocale for LC_TIME
• - Zend Date
• - sapphire Money Class based on Zend Currency
• - sapphire deprecated Currency class for compatibility

Da muss man dann schauen was für einen passt, das Modul unterstützt auf jeden Fall alle diese.

Installiert wird es, wie alle Silverstripe Module, einfach in die Root-ebene des Projects kopieren und fertig.

In der mysite/_config.php muss man dann einfach die jeweilige Datums oder Currency Klasse
mit der Subklasse des Moduls ersetzen und schon hat man den vollen Zugriff auf zB die ZEND Datums Klasse

i18n::set_default_locale('de_DE');
Object::useCustomClass('SS_Datetime','ZendDate',true);

Will man kein Zend benutzen, kann der PHP Weg über die locale gegangen werden.
Die Formatierungen finden sich im lang file des Moduls, können aber auch explizit angegeben werden.

Alle Möglichkeiten sind in der _config.php erklärt:

//Date Formating -the PHP way-
//Object::useCustomClass('SS_Datetime','I18nDatetime', true);
//values then come from the lang file
//if you want to use custom formating then set also:
//I18nDatetime::setFormatNice('%e. %B %G');

//Date Formating -the Zend way-
//Object::useCustomClass('SS_Datetime','ZendDate', true);
//values then come from the lang file
//if you want to use custom formating then set also:
//ZendDate::setFormatNice('j. F Y, G:i');

//Money Formating -the SS Currency Way-
//Object::useCustomClass('Currency','I18nCurrency', true)
//values then come from the lang file
//if you want to use custom formating then set also:
//I18nCurrency::setDecimalDelimiter(',');
//I18nCurrency::setThousandDelimiter('.'); 

//Money Formating -the Money / Zend way -
//Object::useCustomClass('Money','CustomMoney', true);
//@see http://framework.zend.com/manual/en/zend.currency.options.html
//CustomMoney::setOptions(array('display' => Zend_Currency::USE_SHORTNAME,
//                                                        'position' => Zend_Currency::RIGHT));

Auf meiner TODO stehen dann noch weitere Sprachfiles, sowie ein paar UnitTests.
Probierts mal aus und über feedback freut man sich natürlich.

Juhu:
http://silverstripe.org/silverstripe-2-4-release-a-significant-step-forward/

Musste neulich so einen “Web 2.0 Mirror FX” haben und bin über 2 interessante Lösungen gestolpert:

Silverstripe & GD:
http://www.ssbits.com/web-2-0-mirrored-images/

jQuery & Canvas:
http://www.digitalia.be/software/reflectionjs-for-jquery#demo

weitergehende Erklärungen dazu spare ich mir jetzt mal, sind ja beide gut dokumentiert :)

… und wieder Silverstripe.

Lokalisierte Dates macht Silverstripe nicht out-of-the-box, man muss da ein bißchen was umbauen:

In der _config.php

i18n::set_locale('de_DE');
setlocale (LC_ALL, 'de_DE@euro', 'de_DE.UTF-8', 'de_DE', 'de', 'ge');

Die Silverstripe (2.3.6) Lokalisierung alleine reicht da nicht.
Ich nehme an das wird in 2.4 sich ändern.

Um im Frontend dann sowas zu bekommen : 12 März 2010

benutzt man statt

$Created.Long

lieber

$Created.FormatI18N(%d %B %G)

thereifixedit:
Wenn man bei einem Silverstripe Projekt häufige Änderungen an verschachtelten Templates hat,
kommt man, soweit ich weiss, nicht umhin

?flush=1
oder
?flush=all

an den Seitenaufruf anzuhängen um die Änderungen sichtbar zu machen.

Weil ich gerade sehr häufig in der Situation bin, also jede Minute, hatte ich gehofft man könnte den Cache irgendwo abschalten.
In der Richtung habe ich aber nichts gefunden.

Es lohnt aber ggf. lokal den Parameter einfach immer zu setzen.
Allzu langsam wird das ganze dadurch auch nicht.

also in der _config.php

if ( strpos( $_SERVER["REQUEST_URI"], 'admin' ) === false ) {
  $_GET["flush"] = 1;
}

:D

ziemliche Krücke, aber hilft erstmal weiter.

Gibt es einen eleganteren Weg, den ich auf die Schnelle nicht gefunden habe?
Oder liegt das nur an meinem Template Design dass ich das dauernd brauche? :)

Silverstripe bzw. das drunterliegende Framework Sapphire hat ja eine GeoIp Komponente, die in dem CMS und auch in einigen Modulen benutzt wird, zB um Länder in Formularen direkt einzustellen.

Was allerdings nirgendwo steht ist, dass dafür das Programm geoiplookup benötigt wird.

Sapphire ruft das Programm dann über exec auf.

Ist das nicht installiert, stehen im Apache error.log solche Meldungen:

sh: geoiplookup: not found

… und zwar nur da. Im Code wird kein Fehler angezeigt.

Also schnell installieren

apt-get install libgeoip1 geoip-bin

und alles klappt.

Wie das dann allerdings auf Windows aussieht kann ich nicht sagen ;)