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.

Blog Module /

Discuss the Blog Module.

Moderators: martimiz, Sean, biapar, Willr, Ingo, swaiba, simon_w

Basic Guide


Reply


7 Posts   1149 Views

Avatar
kennybrijs

Community Member, 4 Posts

4 June 2010 at 1:06am

Edited: 04/06/2010 1:15am

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

Avatar
Willr

Forum Moderator, 5513 Posts

4 June 2010 at 12:09pm

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.

Avatar
kennybrijs

Community Member, 4 Posts

4 June 2010 at 10:47pm

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

Avatar
DsX

Community Member, 178 Posts

5 June 2010 at 4:47am

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.

Avatar
DsX

Community Member, 178 Posts

5 June 2010 at 4:48am

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

Avatar
kennybrijs

Community Member, 4 Posts

7 June 2010 at 10:21pm

Ok, thanks mate ;)

I'll be starting with the first tutorial ;)

Avatar
kennybrijs

Community Member, 4 Posts

7 June 2010 at 10:34pm

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.