Hi all

I'm giving silverstripe a try (just been busy with MODx for a while).

I'm trying to make use of the blog module, but I'm having a hard time finding basic documentation.

How to show latest posts, tag clouds, ... on a page? Which controls or variables do I need?

I like silverstripe but I think it's pretty complex, if anyone could point me to some clear documentation (I've already been to the basic tutorials of course http://doc.silverstripe.org/tutorials).

Greetings, Kenny.

EDIT: Oh by the way, I'm using my own template, so I guess I just need to know the names of the controls/variables to put in the template

EDIT: Oh by the way, I'm using my own template, so I guess I just need to know the names of the controls/variables to put in the template

I think the best way of seeing how the blog works is to look through the templates that come with the blog. Not much module specific information on blog but if you look through the BlogHolder.ss and BlogPage.ss files in blog/templates you can see what variables it uses. The latest posts, clouds are a bit more tricky since these are widgets. Each widget has its own template and controls.

Well, I thought about checking files like that, but I'm a bit confused.

There are two "BlackCandy" templates:

/themes/blackcandy with (in /templates)

• /Page.ss
  
• /Includes/BreadCrumbs.ss
  
• /Includes/Footer.ss
  
• /Includes/Navigation.ss
  
• /Includes/SideBar.ss
  
• /Layout/Page.ss
  
• /Layout/Page_results.ss
  

and

/themes/blackcandy_blog with (in /templates)

• /WidgetHolder.ss
  

So nothing really blog related as far as I know...

I'm using Silverstripe 2.4 by the way, maybe that has something to do with it.

Greetings, Kenny

OK, vist I'll give you the resource I found very help in this regards (I came from working with ModX as well): http://doc.silverstripe.org/themes:developing

What you need to know it that the 2 template folders are both part of the same theme.. this means that because of the naming SilverStripe (SS) reads them as related... so if you installed for example the forum module, you would create a blackcandy_forum folder to contain the templates for the forum and have that folder as part of your blackcandy theme.. if you create your own theme you will need to have folders like: YourTheme, YourTheme_blog, YourThem_forum etc...

One other note is that SS also looks in the module folder itself for templates... these are the templates you override if you create folders eg BlackCandy_blog (the WidgetHolder.ss file you found here simply overrides the one found in the blog module folder I believe).

Read the page I posted and take special attention to the section Overriding.

I also must recommend this page for listing many great resources: http://ssbits.com/10-super-useful-silverstripe-documentation-pages/

Ok, thanks mate ;)

I'll be starting with the first tutorial ;)

Oh by the way, what do you think of SS in comparison to MODx?

I pretty much like it, but I do think it's more difficult.