Skip to main content

This site requires you to update your browser. Your browsing experience maybe affected by not having the most up to date version.

We've moved the forum!

Please use for any new questions (announcement).
The forum archive will stick around, but will be read only.

You can also use our Slack channel or StackOverflow to ask for help.
Check out our community overview for more options to contribute.

Archive /

Our old forums are still available as a read-only archive.

Moderators: martimiz, Sean, Ed, biapar, Willr, Ingo

How do i do the tutorials?

Go to End

7 Posts   4717 Views


Community Member, 4 Posts

12 December 2008 at 6:12am

Edited: 12/12/2008 6:23am

OK I install SilverStripe without any hitches.

During the installation it gave me a choice of themes saying i could change later if i wanted to do the tutorials.

So now i want to do the tutorials, how do i change the theme?


Carbon Crayon

Community Member, 598 Posts

12 December 2008 at 7:11am

Edited: 12/12/2008 7:24am

Hi adam, welcome to silverstripe :)

themes are changed in the _config.php file which will be found in 'mysite'
you will see a line which reads:


To change the theme you just swap 'blackcandy' with the theme name that you want to use, so you would change it to:


you will also need to change the project as the tutorial uses the tutorial folder to store the code files. Look for the following line at the top of _config.php:

$project = 'mysite';

and change it to

$project = 'tutorial';


Community Member, 4 Posts

13 December 2008 at 9:38am

Edited: 13/12/2008 9:39am

Hi Aram

Thanks for that.

I actually reinstalled the whole thing but chose the tutorial option at install time.

I thought if i did the tutorials things would become clearer ...

So i've now done the first two ( and very good they are too) but i'm non the wiser about switching themes yet....

I couldn't understand your answer as after i reinstalled there was no config file inside the mysite folder, so it's just disappeared rather than changed.

Someone mentioned this 4 months ago:

Joe Golike 4
"I'm a web developer myself, and pretty comfortable with PHP code. But after installing, I couldn't figure out how to switch to a different theme. You'd think that would be a pretty important feature that it would be obvious in the UI"

So i guess this is still to be revealed...


Carbon Crayon

Community Member, 598 Posts

15 December 2008 at 5:57am

Hi adam

I think if you install for the tutorials then the _config.php file is in the 'tutorial' folder. Just follow the same instructions and change the appropriate line to your theme name and it should all be good :)

If you have any more trouble don't hesitate to post, I'll try to be a bit more prompt with my answer next time! hehe

p.s. if you are ready to start a proper site, I'd recomend installing with the blackcandy theme selected so that your config file is in the correct folder.


Community Member, 4 Posts

15 December 2008 at 11:52am

OK I've done all the tutorials now so:

Question 1:

In tutorial 5 why did Projects need a special page of type ProjectHolder to put the Projects in
while Mentor pages could be put directly into a regular page type?

Question 2:

I still don't inderstand the _config.php business. I've now finished the tutorials and am ready to start my own project. So how do i start that without reinstalling the whole thing? (I'm afraid i need it spelling out)



Community Member, 400 Posts

15 December 2008 at 2:32pm

Edited: 15/12/2008 2:36pm

the ProjectHolder is used to manage the content, with out making it complex,

see in the tutorial they have used a NewHolder, this is the same like that one,

Have you work with any CMS system? all use some file to store the information which helps to run the CMS, like database host, db password and stuff.

In SilverStripe the _config.php in the mysite folder stores those directives, which the CMS use to run.
Also in the directory structure, when ever you have a folder, and a _config.php the CMS understand that it is as module, and runs the code. If it is not there it wont run the codes. And these _config.php files in the folders can store the configuration options which relevant to that specific module.


Community Member, 4 Posts

15 December 2008 at 10:56pm

My answer to Question 1:

In the Mentor example there is actually no specific (to a
mentor) content on the Mentor (holder) page (which is just a normal page) so you
can just add normal content; whereas on the ProjectHolder page we put the table
of all the projects (which needs is own template that can access Project
properties), a normal page would just use the template so a
ProjectHolder class is created so that it will look for the template
hence we can have customized content on the ProjectHolder page.

Question 2:

How do i start a new project?

I moved the _config.php folder from the tutorials folder to the mysite folder and i

$project = 'tutorial';
$project = 'mysite';

But no good I get an HTTP 500 error

So then i then i tried a dB flush
- success!!

But wait a minute, this is still the turorial site!!

I clearly haven't grasped the concepts here.

I though a new folder would = new web site, new objects different pages

How can _config.php in the mysite folder still be using the objects from the tutorials folder???

Is it one web site = 1 installation of SilverStripe , and different project folders (eg mysite, tutorials) are the same pages with different themes?