# Built-in Page Controls Ever wonder when you use `$Title` and `<% Control Children %>` what else you can call in the templates?. This page is here to help with a guide on what template controls you can call. **Note for advanced users:** These built-in page controls are defined in the [api:SiteTree] classes, which are the 'root' data-object and controller classes for all the sites. So if you're dealing with something that isn't a sub-class of one of these, our handy reference to 'built-in page controls' won't be so relevant. ## Page controls that can't be nested These page controls are defined on the **controller** which means they can only be used at a top level, not nested within another page control. ### Controlling Menus Datafeeds #### <% control Menu(1) %>, <% control Menu(2) %>, ... Returns a fixed level menu. Because this only works in the top level, you can't use it for nested menus. Use `<% control Children %>` instead. You can nest `<% control Children %>`. #### <% control ChildrenOf(page-url) %> This will create a datafeed of the children of the given page. Handy if you want a list of the subpages under staff (eg the staff) on the homepage etc ### Controlling Certain Pages #### <% control Level(1) %>, <% control Level(2) %>, $Level(1).Title, $Level(2).Content, etc Returns the current section of the site that we're in, at the level specified by the numbers. For example, imagine you're on the page __about us > staff > bob marley__: * `<% control Level(1) %>` would return the about us page * `<% control Level(2) %>` would return the staff page * `<% control Level(3) %>` would return the bob marley page #### <% control Page(my-page) %>$Title<% end_control %> "Page" will return a single page from the site tree, looking it up by URL. You can use it in the `<% control %>` format. Can't be called using `$Page(my-page).Title`. ## Page controls that can be used anywhere These are defined in the data-object and so can be used as nested page controls. Lucky us! we can control Children of Children of Children for example. ### Conditional Logic SilverStripe supports a simple set of conditional logic :::ss <% if Foo %> // if Foo is true or an object do this <% else_if Bar %> // if Bar is true or an object do this <% else %> // then do this by default <% end_if %> See more information on conditional logic on [templates](/topics/templates). ### Site wide settings Since 2.4.0, SilverStripe provides a generic interface for accessing global properties such as *Site name* or *Site tag line*. This interface is implemented by the [api:SiteConfig] class. ### Controlling Parents and Children #### <% control Children %> This will return the children of the current page as a nested datafeed. Useful for nested navigations such as pop-out menus. #### <% control AllChildren %> This will show all children of a page even if the option 'show in menus?' is unchecked in the tab panel behaviour. #### <% control Parent %> or $Parent.Title, $Parent.Content, etc This will return the parent page. The $ variable format lets us reference an attribute of the parent page directly. ### Site Navigation - Breadcrumbs #### $Breadcrumbs This will return a breadcrumbs widget for the current page. You can call this on any SiteTree descendant, so, for example, you could display the breadcrumbs of every search result if you wanted. The Breadcrumbs method returns a string of text, so this can't be used as a control block (that is, you can't usefully say "<% control Breadcrumbs %>"). You can limit the number of items in the breadcrumbs, as well as whether the breadcrumb items are links. #### $Breadcrumbs(3) This returns a maximum of 3 pages in the breadcrumb list, which can be handy if you want to limit the size of your breadcrumbs to conform to your page design. #### <% control Breadcrumbs(3, true) %> This returns the same, but without any links. This is handy if you want to put the breadcrumb list into another link tag. ### Links and Classes #### $LinkingMode, $LinkOrCurrent and $LinkOrSection These return different linking modes. $LinkingMode provides the greatest control, outputting 3 different strings: * link: Neither this page nor any of its children are current open. * section: A child of this page is currently open, which means that we're currently in this section of the site. * current: This page is currently open. A useful way of using this is in your menus. You can use the following code below to generate class="current" or class="section" on your links. Take the following code :::ss
  • $Title
  • When viewed on the Home page it will render like this :::ss
  • Home
  • `$LinkOrCurrent` ignores the section status, returning link instead. `$LinkOrSection` ignores the current status, returning section instead. Both of these options can simplify your CSS when you only have 2 different cases to consider. #### <% if LinkOrCurrent = current %> This is an alternative way to set up your menus - if you want different HTML for the current menu item, you can do something like this: :::ss <% if LinkOrCurrent = current %> $Title <% else %> $Title <% end_if %> #### <% if LinkOrSection = section %> Will return true if you are on the current page OR a child page of the page. Useful for menus which you only want to show a second level menu when you are on that page or a child of it #### <% if InSection(page-url) %> This if block will pass if we're currently on the page-url page or one of its children. ### Titles and CMS Defined Options #### $MetaTags This returns a segment of HTML appropriate for putting into the `` tag. It will set up title, keywords and description meta-tags, based on the CMS content. If you don't want to include the title-tag (for custom templating), use **$MetaTags(false)**. #### $MenuTitle This is the title that you should put into navigation menus. CMS authors can choose to put a different menu title from the main page title. #### $Title This is the title of the page which displays in the browser window and usually is the title of the page. :::ss

    $Title

    #### $URLSegment This returns the part of the URL of the page you're currently on. Could be handy to use as an id on your body-tag. ( when doing this, watch out that it doesn't create invalid id-attributes though.). This is useful for adding a class to the body so you can target certain pages. Watch out for pages named clear or anything you might have used in your CSS file :::ss #### $ClassName Returns the ClassName of the PHP object. Eg if you have a custom HomePage page type with `$ClassName` in the template, it will return "HomePage" #### $BaseHref Returns the base URL for the current site. This is used to populate the `` tag by default, so if you want to override `<% base_tag %>` with a specific piece of HTML, you can do something like `` ### Controlling Members and Visitors Data #### <% control CurrentMember %>, <% if CurrentMember %> or $CurrentMember.FirstName CurrentMember returns the currently logged in member, if there is one. All of their details or any special Member page controls can be called on this. Alternately, you can use `<% if CurrentMember %>` to detect whether someone has logged in. To Display a welcome message you can do :::ss <% if CurrentMember %> Welcome Back, $CurrentMember.FirstName <% end_if %> If the user is logged in this will print out :::ss Welcome Back, Admin #### <% if IsRepeatMember %> Detect the visitor's previous experience with the site. `$IsRepeatMember` will return true if the visitor has signed up or logged in on the site before. Note that as of version 2.4 `$PastVisitor` is deprecated. If you wish to check if a visitor has been to the site before, set a cookie with `Cookie::set()` and test for it with `Cookie::get()`. Note that in 2.4 this variable was called `$PastMember`. This still works in 3.0 but is deprecated. ### Date and Time #### $Now.Nice, $Now.Year `$Now` returns the current date. You can call any of the methods from the [api:Date] class on it. #### $Created.Nice, $Created.Ago `$Created` returns the time the page was created, `$Created.Ago` returns how long ago the page was created. You can also call any of methods of the [api:Date] class on it. #### $LastEdited.Nice, $LastEdited.Ago `$LastEdited `returns the time the page was modified, `$LastEdited.Ago` returns how long ago the page was modified. You can also call any of methods of the [api:Date] class on it. ### DataObjectSet Options If you are using a DataObjectSet you have a wide range of methods you can call on it from the templates #### <% if Even %>, <% if Odd %>, $EvenOdd These controls can be used to do zebra-striping. `$EvenOdd` will return 'even' or 'odd' as appropriate. #### <% if First %>, <% if Last %>, <% if Middle %>, $FirstLast These controls can be used to set up special behaviour for the first and last records of a datafeed. `<% if Middle %>` is set when neither first not last are set. `$FirstLast` will be 'first', 'last', or ''. #### $Pos, $TotalItems `$TotalItems` will return the number of items on this page of the datafeed, and `$Pos` will return a counter starting at 1. #### $Top When you're inside a control loop in your template, and want to reference methods on the current controller you're on, breaking out of the loop to get it, you can use `$Top` to do so. For example: :::ss $URLSegment <% control News %> $URLSegment $Top.URLSegment <% end_control %> ## Properties of a datafeed itself, rather than one of its items If we have a control such as `<% control SearchResults %>`, there are some properties, such as `$SearchResults.NextLink`, that aren't accessible within `<% control SearchResults %>`. These can be used on any datafeed. ### Search Results #### <% if SearchResults.MoreThanOnePage %> Returns true when we have a multi-page datafeed, restricted with a limit. #### $SearchResults.NextLink, $SearchResults.PrevLink This returns links to the next and previous page in a multi-page datafeed. They will return blank if there's no appropriate page to go to, so `$PrevLink` will return blank when you're on the first page. You can therefore use `<% if PrevLink %>` to keep your template tidy. #### $SearchResults.CurrentPage, $SearchResults.TotalPages CurrentPage returns the number of the page you're currently on, and TotalPages returns the total number of pages. #### $SearchResults.TotalItems This returns the total number of items across all pages. #### <% control SearchResults.First %>, <% control SearchResults.Last %> These controls return the first and last item on the current page of the datafeed. #### <% control SearchResults.Pages %> This will return another datafeed, listing all of the pages in this datafeed. It will have the following data available: * **$PageNum:** page number, starting at 1 * **$Link:** a link straight to that page * `<% if CurrentBool %>`:** returns true if you're currently on that page `<% control SearchResults.Pages(30) %>` will show a maximum of 30 pages, useful in situations where you could get 100s of pages returned. #### $SearchResults.UL This is a quick way of generating a `