VirtualPage

class VirtualPage extends Page (View source)

Virtual Page creates an instance of a page, with the same fields that the original page had, but readonly.

This allows you can have a page in mulitple places in the site structure, with different children without duplicating the content Note: This Only duplicates $db fields and not the $has_one etc..

Properties

public static $virtualFields

Methods

public
getVirtualFields()

Generates the array of fields required for the page type.

public
SiteTree
CopyContentFrom()

No description

public
setCopyContentFromID($val)

No description

public
ContentSource()

No description

public
string
MetaTags(bool $includeTitle = true)

For VirtualPage, add a canonical link tag linking to the original page See TRAC #6828 & http://support.google.com/webmasters/bin/answer.py?hl=en&answer=139394

public
allowedChildren()

No description

public
syncLinkTracking()

No description

public
canPublish($member = null)

We can only publish the page if there is a published source page

public
canDeleteFromLive($member = null)

Return true if we can delete this page from the live site, which is different from can we publish it.

public
isPublishable()

Returns true if is page is publishable by anyone at all Return false if the source page isn't published yet.

public
getCMSFields()

Generate the CMS fields from the fields from the original page.

public
getSettingsFields()

No description

public
onBeforeWrite()

We have to change it to copy all the content from the original page first.

public
onAfterWrite()

No description

protected
validate()

No description

public
copyFrom($source, $updateImageTracking = true)

Ensure we have an up-to-date version of everything.

public
updateImageTracking()

No description

public
string
CMSTreeClasses(string $numChildrenMethod = "numChildren")

No description

public
mixed
__get(string $field)

Allow attributes on the master page to pass through to the virtual page

public
mixed
__isset(string $field)

Allow attributes on the master page to pass through to the virtual page

public
mixed
__call(string $method, string $args)

Pass unrecognized method calls on to the original data object

public
bool
hasField(string $field)

No description

public
bool
hasMethod(string $method)

Overwrite to also check for method on the original data object

public
string
castingHelper(string $field)

Return the "casting helper" (a piece of PHP code that when evaluated creates a casted value object) for a field on this object.

Details

at line 52
getVirtualFields()

Generates the array of fields required for the page type.

at line 69
SiteTree CopyContentFrom()

No description

Return Value

SiteTree

Returns the linked page, or failing that, a new object.

at line 90
setCopyContentFromID($val)

No description

Parameters

$val

at line 95
ContentSource()

No description

at line 106
string MetaTags(bool $includeTitle = true)

For VirtualPage, add a canonical link tag linking to the original page See TRAC #6828 & http://support.google.com/webmasters/bin/answer.py?hl=en&answer=139394

Parameters

bool $includeTitle

Show default -tag, set to false for custom templating</p></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>string</td> <td><p>The XHTML metatags</p></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_allowedChildren"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L114">at line 114</a></div> <code> <strong>allowedChildren</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_syncLinkTracking"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L120">at line 120</a></div> <code> <strong>syncLinkTracking</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_canPublish"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L131">at line 131</a></div> <code> <strong>canPublish</strong>($member = null) </code> </h3> <div class="details"> <div class="method-description"> <p><p>We can only publish the page if there is a published source page</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td></td> <td>$member</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_canDeleteFromLive"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L139">at line 139</a></div> <code> <strong>canDeleteFromLive</strong>($member = null) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Return true if we can delete this page from the live site, which is different from can we publish it.</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td></td> <td>$member</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_isPublishable"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L149">at line 149</a></div> <code> <strong>isPublishable</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p><p>Returns true if is page is publishable by anyone at all Return false if the source page isn't published yet.</p></p> <p><p>Note that isPublishable doesn't affect ete from live, only publish.</p></p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_getCMSFields"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L167">at line 167</a></div> <code> <strong>getCMSFields</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p><p>Generate the CMS fields from the fields from the original page.</p></p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_getSettingsFields"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L233">at line 233</a></div> <code> <strong>getSettingsFields</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_onBeforeWrite"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L256">at line 256</a></div> <code> <strong>onBeforeWrite</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p><p>We have to change it to copy all the content from the original page first.</p></p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_onAfterWrite"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L299">at line 299</a></div> <code> <strong>onAfterWrite</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_validate"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L347">at line 347</a></div> <code> protected <strong>validate</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_copyFrom"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L369">at line 369</a></div> <code> <strong>copyFrom</strong>($source, $updateImageTracking = true) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Ensure we have an up-to-date version of everything.</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td></td> <td>$source</td> <td></td> </tr> <tr> <td></td> <td>$updateImageTracking</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_updateImageTracking"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L387">at line 387</a></div> <code> <strong>updateImageTracking</strong>() </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> </div> </div> </div> <div class="method-item"> <h3 id="method_CMSTreeClasses"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L402">at line 402</a></div> <code> string <strong>CMSTreeClasses</strong>(string $numChildrenMethod = "numChildren") </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$numChildrenMethod</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>string</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method___get"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L413">at line 413</a></div> <code> mixed <strong>__get</strong>(string $field) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Allow attributes on the master page to pass through to the virtual page</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$field</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>mixed</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method___isset"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L431">at line 431</a></div> <code> mixed <strong>__isset</strong>(string $field) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Allow attributes on the master page to pass through to the virtual page</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$field</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>mixed</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method___call"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L448">at line 448</a></div> <code> mixed <strong>__call</strong>(string $method, string $args) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Pass unrecognized method calls on to the original data object</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$method</td> <td></td> </tr> <tr> <td>string</td> <td>$args</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>mixed</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_hasField"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L460">at line 460</a></div> <code> bool <strong>hasField</strong>(string $field) </code> </h3> <div class="details"> <div class="method-description"> <p class="no-description">No description</p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$field</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>bool</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_hasMethod"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L473">at line 473</a></div> <code> bool <strong>hasMethod</strong>(string $method) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Overwrite to also check for method on the original data object</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$method</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>bool</td> <td></td> </tr> </table> </div> </div> </div> <div class="method-item"> <h3 id="method_castingHelper"> <div class="location"><a href="https://github.com/silverstripe/silverstripe-cms/blob/3/code/model/VirtualPage.php#L487">at line 487</a></div> <code> string <strong>castingHelper</strong>(string $field) </code> </h3> <div class="details"> <div class="method-description"> <p><p>Return the "casting helper" (a piece of PHP code that when evaluated creates a casted value object) for a field on this object.</p></p> </div> <div class="tags"> <h4>Parameters</h4> <table class="table table-condensed"> <tr> <td>string</td> <td>$field</td> <td></td> </tr> </table> <h4>Return Value</h4> <table class="table table-condensed"> <tr> <td>string</td> <td></td> </tr> </table> </div> </div> </div> </div> </div><div id="footer"> Generated by <a href="https://github.com/code-lts/doctum">Doctum, a API Documentation generator and fork of Sami</a>. <br/>Contributions to this documentation repository are welcomed <a href="https://github.com/silverstripe/api.silverstripe.org" rel="noreferrer noopener" target="_blank">on Github!</a> </div></div> </div> </body> </html>