This is a reoccuring requirement: you need a profile for some object in your project.
FE you have a company, a member or a location that should get an address, a marker on the map, an icon, homepage etc.

So I created a small silverstripe module that adds a profile tab to any object you choose in your Silverstripe CMS backend.

It basically extends the very handy addressable module and inherits all functionality from it like automatic geocoding, regex field to validate postcodes, set allowed countries and rendering of a static google map.
If you just need an Address I recommend to use the addressable module.

Install it easy by:
Simply extend your Object in your _config.php:

Object::add_extension('myObject', 'Profileable');

To add the automatic geocoding add:

Object::add_extension('myObject', 'Geocodable');

and of course run: dev/build?flush=all

It also renders the profile in semantic hContact mircroformat markup, just place $getFullProfileHTML in your template and style it.
If you want to render the Profile different just copy the Profile.ss over to your theme and start editing.

Read more in the readme’s :)

to be honest i didn’t find a clean way yet, but i thought this workaround might be worth sharing.

…since Silverstripes‘ Userforms Module Uses jQuery for Validation you can put these lines of code in your UserDefinedForm.ss Template:

jQuery(document).ready(function(){
    jQuery('form label').each(function(){
      jQuery(this).parent().find('input, textarea').attr('placeholder', jQuery(this).html());
      jQuery(this).remove();
    })
  });

This will iterate over the labels in the form , build placeholder attributes from each one and then remove it.

If anyone knows a way how to do this in PHP, i’d appreciate a comment :)

When you duplicate a page in the Silverstripe Sitetree, related “has_one” Items are automatically copied, which is nice.

But if you have, lets say, multiple related images on that Page, those are not copied when you duplicate that Page.

After reading this discussion, i found out that it’s actually pretty easy to “fix” this.

This what i ended up with and seems to be working fine:

//assuming your page has the following related Dataobjects

public static $has_many = array(
'Images' => 'MyImageDataObject'
);

public static $many_many = array(
'Something' => 'AnotherPageTypeOrWhatever

);

The following code would automatically duplicate the has_many related DataObjects
and just set the relation to the many_many Objects on the created page:

        

          

              
<?php 

public function duplicate() {
 
  $items_to_duplicate = array(
    'Images',
    'Somehting'
  );
 
  $page = parent::duplicate();
 
  //duplicate has many items
  foreach ($this->has_many() as $key => $className) {
    if (in_array($key, $items_to_duplicate)) {
      foreach ($this->{$key}() as $item) {
        $newField = $item->duplicate();
        $id = get_class($this) . 'ID';
        $newField->{$id} = $page->ID;
        $newField->write();
      }
    }
  }
 
  //set the relation to many_many items on created page
  foreach ($this->many_many() as $key => $className) {
    if (in_array($key, $items_to_duplicate)) {
     $page->{$key}()->addMany($this->{$key}()->getIdList());
    }
  }
 
  return $page;
}
          

          

            view raw
            silverstripe_duplicate_relations.php
            This Gist brought to you by GitHub.
          
        

..as already suggested in the forum, i still think this would make a handy core feature, wouldn’t it?
Would be cool to globally specify relations to duplicate in the page-config with something like

public static $relations_to_copy = array(
 'Images',
 'Somehting'
);

We thought we had to improve our SilverStripe setup script for our development environment.
So Max and me rewrote it to add submodules and some other improvements.

Just run:

./install_silverstripe.sh mynewproject tags/2.4.7

and you have

• silverstripe project folder structure
• the tutorial theme
• a already filled git repository
• sapphire as submodule
• cms as submodule
• Uploadify as submodule
• DataObjectManager as submodule
• UserForms as submodule

What you then still need to do is:

• create the database
• setup a local vhost
• open your project url and run the install process
• start to code

So here it is:

# 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

#set up project base folder
git clone git@github.com:silverstripe/silverstripe-installer.git $1
cd $1
git checkout $2
#we kill the .git because we want this repo just as starter and init our own repository (instead of export)
rm -rf .git

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

git init

git submodule add git@github.com:silverstripe/silverstripe-cms.git cms
cd cms
git checkout $2
cd ..
git add cms
git commit -m "checked out submodule cms to $2"

git submodule add git@github.com:silverstripe/sapphire.git sapphire
cd sapphire
git checkout $2
cd ..
git add sapphire
git commit -m "checked out submodule sapphire to $2"

# add common modules
git submodule add git://github.com/unclecheese/Uploadify.git uploadify
git submodule add git://github.com/unclecheese/DataObjectManager.git dataobject_manager
git submodule add git://github.com/silverstripe/silverstripe-userforms.git userform

git submodule init
git submodule update

git add .
git commit -m "Initial Commit"

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/