Jump to:

1851 Posts in 1606 Topics by 561 members

Blog Module

SilverStripe Forums » Blog Module » Basic Guide

Discuss the Blog Module.

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

Page: 1
Go to End
Author Topic: 1124 Views
  • kennybrijs
    Avatar
    Community Member
    4 Posts

    Basic Guide Link to this post

    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

  • Willr
    Avatar
    Forum Moderator
    5497 Posts

    Re: Basic Guide Link to this post

    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.

  • kennybrijs
    Avatar
    Community Member
    4 Posts

    Re: Basic Guide Link to this post

    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

  • DsX
    Avatar
    Community Member
    178 Posts

    Re: Basic Guide Link to this post

    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.

  • DsX
    Avatar
    Community Member
    178 Posts

    Re: Basic Guide Link to this post

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

  • kennybrijs
    Avatar
    Community Member
    4 Posts

    Re: Basic Guide Link to this post

    Ok, thanks mate ;)

    I'll be starting with the first tutorial ;)

  • kennybrijs
    Avatar
    Community Member
    4 Posts

    Re: Basic Guide Link to this post

    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.

    1124 Views
Page: 1
Go to Top

Want to know more about the company that brought you SilverStripe? Then check out SilverStripe.com

Comments on this website? Please give feedback.