SetPageTextVariable

Summary: Set PageTextVariables in config.php
Version: 1.1
Prerequisites: none
Status: Working
Maintainer:
Categories: PageVariables

Questions answered by this recipe

This section is optional; use it to indicate the types of questions (if any) this recipe is intended to answer.

Description

Set a PageTextVariable in config.php

Currently you can read a PageTextVariable using the PageTextVar(). This recipe allows you to also set a PageTextVariable.

Syntax:
SetPageTextVariable($pagename, $ptv, $val);

In the example above the $pagename variable would have a value like "Main.MyDataPage", the $ptv would be the name of a PageTextVariable, and $val would be the value to set it to.

WARNING: If you change a PageTextVariable that is currently being viewed you should restart the page using the redirect function to the same page. For example, if you are viewing page "Main.MyDataPage" and your code sets PageTextVariables, at the very end of the code you would have the line Redirect("Main.MyDataPage");

Installing

Copy SetPageTextVariable.phpΔ to your cookbook directory

In your config.php enter:

include_once("cookbook/SetPageTextVariable .php");

or in your farmconfig.php enter:

include_once("$FarmD/cookbook/SetPageTextVariable .php");

Notes

Release Notes

  • Version: 1.0 - Initial Release

Comments

See Also

  • PTVReplace Add link markup or input forms to replace values in PTVs
  • Toolbox has functions WritePTV() and ptv2text() which do similar things

Contributors

User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.