From 30dc659e9c148cd7c4cd7d94ca73a6be8c857a80 Mon Sep 17 00:00:00 2001 From: Colin Kuskie Date: Fri, 25 Feb 2005 03:50:45 +0000 Subject: [PATCH] moved Asset/Template help into its own files --- lib/WebGUI/Help/Template.pm | 62 ++++++++++++ lib/WebGUI/Help/WebGUI.pm | 66 ++----------- lib/WebGUI/i18n/English/Template.pm | 143 +++++++++++++++++++++++++++ lib/WebGUI/i18n/English/WebGUI.pm | 145 +--------------------------- 4 files changed, 214 insertions(+), 202 deletions(-) create mode 100644 lib/WebGUI/Help/Template.pm diff --git a/lib/WebGUI/Help/Template.pm b/lib/WebGUI/Help/Template.pm new file mode 100644 index 000000000..ee7a112f8 --- /dev/null +++ b/lib/WebGUI/Help/Template.pm @@ -0,0 +1,62 @@ +package WebGUI::Help::Template; + +our $HELP = { + + 'templates manage' => { + title => '683', + body => '638', + related => [ + { + tag => 'themes manage', + namespace => 'WebGUI' + }, + { + tag => 'template add/edit', + namespace => 'Template' + }, + { + tag => 'template delete', + namespace => 'Template' + }, + { + tag => 'template language', + namespace => 'Template' + } + ] + }, + 'template add/edit' => { + title => '684', + body => '639', + related => [ + { + tag => 'templates manage', + namespace => 'Template' + } + ] + }, + + 'template delete' => { + title => '685', + body => '640', + related => [ + { + tag => 'templates manage', + namespace => 'Template' + } + ] + }, + + 'template language' => { + title => '825', + body => '826', + related => [ + { + tag => 'templates manage', + namespace => 'Template' + } + ] + }, + +}; + +1; diff --git a/lib/WebGUI/Help/WebGUI.pm b/lib/WebGUI/Help/WebGUI.pm index 2450b8258..b90267c1c 100644 --- a/lib/WebGUI/Help/WebGUI.pm +++ b/lib/WebGUI/Help/WebGUI.pm @@ -68,11 +68,11 @@ our $HELP = { }, { tag => 'template language', - namespace => 'WebGUI' + namespace => 'Template' }, { tag => 'templates manage', - namespace => 'WebGUI' + namespace => 'Template' } ] }, @@ -343,48 +343,7 @@ our $HELP = { } ] }, - 'templates manage' => { - title => '683', - body => '638', - related => [ - { - tag => 'themes manage', - namespace => 'WebGUI' - }, - { - tag => 'template add/edit', - namespace => 'WebGUI' - }, - { - tag => 'template delete', - namespace => 'WebGUI' - }, - { - tag => 'template language', - namespace => 'WebGUI' - } - ] - }, - 'template add/edit' => { - title => '684', - body => '639', - related => [ - { - tag => 'templates manage', - namespace => 'WebGUI' - } - ] - }, - 'template delete' => { - title => '685', - body => '640', - related => [ - { - tag => 'templates manage', - namespace => 'WebGUI' - } - ] - }, + 'macros using' => { title => '669', body => '624', @@ -461,16 +420,7 @@ our $HELP = { } ] }, - 'template language' => { - title => '825', - body => '826', - related => [ - { - tag => 'templates manage', - namespace => 'WebGUI' - } - ] - }, + 'wobject template' => { title => '827', body => '828', @@ -521,11 +471,11 @@ our $HELP = { }, { tag => 'template language', - namespace => 'WebGUI' + namespace => 'Template' }, { tag => 'templates manage', - namespace => 'WebGUI' + namespace => 'Template' }, { tag => 'user submission system template', @@ -543,7 +493,7 @@ our $HELP = { }, { tag => 'templates manage', - namespace => 'WebGUI' + namespace => 'Template' } ] }, @@ -611,7 +561,7 @@ our $HELP = { related => [ { tag => 'templates manage', - namespace => 'WebGUI' + namespace => 'Template' }, { tag => 'theme delete', diff --git a/lib/WebGUI/i18n/English/Template.pm b/lib/WebGUI/i18n/English/Template.pm index 78b4cd4a2..561475d56 100644 --- a/lib/WebGUI/i18n/English/Template.pm +++ b/lib/WebGUI/i18n/English/Template.pm @@ -31,6 +31,149 @@ our $I18N = { lastUpdated => 1107391368, }, + '683' => { + message => q|Templates, Manage|, + lastUpdated => 1050430164 + }, + + '638' => { + message => q|Templates are used to affect how content is laid out in WebGUI. There are many templates that come with WebGUI, and using the template management system, you can add your own templates to the system to ensure that your site looks exactly how you want it to look. +|, + lastUpdated => 1050430164 + }, + + '684' => { + message => q|Template, Add/Edit|, + lastUpdated => 1038890615 + }, + + '639' => { + message => q|Template Name
+Give this template a descriptive name so that you'll know what it is when you're applying a template to content. +

+ +Namespace
+What type of template is this? +

+ +Template
+Create your template by using template commands and variables, macros, and HTML. +

+ +NOTE: You should never edit the default templates that come with WebGUI as they are subject to change with each new release. Instead, copy the template you wish to edit, and edit the copy.|, + lastUpdated => 1038890615 + }, + + '685' => { + message => q|Template, Delete|, + lastUpdated => 1038791020 + }, + + '640' => { + message => q|It is not a good idea to delete templates as you never know what kind of adverse affect it may have on your site (some content may still be using the template). +

+ +|, + lastUpdated => 1038791020 + }, + + '825' => { + message => q|Template, Language|, + lastUpdated => 1038865669 + }, + + '826' => { + message => q|WebGUI has a powerful templating language built to give you maximum control over the layout of your content. +

NOTES:
+Both the template language and template variables are case-insensitive. +

+Session Variables
+In addition to any variables defined in a given template, of the session variables are made available to you with this syntax: +

+ +<tmpl_var session.section.variable> + +

+In the examples below, please note that the words foo and bar are used as placeholders for the actual variable names that you'll use. They are not part of the template language. + +

+Variables
+Variables are the most basic of the template commands. They are used to position pieces of content. + +

+Syntax: <tmpl_var foo> or <tmpl_var name="foo"> +

+ +Example: <tmpl_var name> +

+ +Conditions
+To programmers conditions are nothing new, but to designers they can often be confusing at first. Conditions are really just true or false questions, and if you think of them that way, you'll have no trouble at all. +

+ +Syntax: <tmpl_if foo> <tmpl_else> </tmpl_if> +
+Syntax: <tmpl_unless foo> <tmpl_else> </tmpl_unless> +

+ +Example: <tmpl_if isTrue> It was true!<tmpl_else> It was false! </tmpl_if> +

+ +

Truth or falsehood is determined by the following rules: +

+ +Loops
+Loops iterate over a list of data output for each pass in the loop. Loops are slightly more complicated to use than plain variables, but are considerably more powerful. +

+ +Syntax: <tmpl_loop foo> </tmpl_loop> +

+ +Example:
+<tmpl_loop users>
+   Name: <tmpl_var first_name><br/>
+</tmpl_loop> +

+ +Loop Conditions
+Loops come with special condition variables of their own. They are __FIRST__, __ODD__, __INNER__, and __LAST__. +

+ +Examples:
+

+   <TMPL_LOOP FOO>
+      <TMPL_IF __FIRST__>
+        This only outputs on the first pass.
+      </TMPL_IF>
+
+      <TMPL_IF __ODD__>
+        This outputs every other pass, on the odd passes.
+      </TMPL_IF>
+
+      <TMPL_UNLESS __ODD__>
+        This outputs every other pass, on the even passes.
+      </TMPL_UNLESS>
+
+      <TMPL_IF __INNER__>
+        This outputs on passes that are neither first nor last.
+      </TMPL_IF>
+
+      <TMPL_IF __LAST__>
+        This only outputs on the last pass.
+      <TMPL_IF>
+   </TMPL_LOOP>
+
+ +

|, + lastUpdated =>1106608811, + }, + }; 1; diff --git a/lib/WebGUI/i18n/English/WebGUI.pm b/lib/WebGUI/i18n/English/WebGUI.pm index 826cad791..42e6563b3 100644 --- a/lib/WebGUI/i18n/English/WebGUI.pm +++ b/lib/WebGUI/i18n/English/WebGUI.pm @@ -390,11 +390,6 @@ The URL of the web site for this theme's designer. If you are in the business of lastUpdated => 1031514049 }, - '684' => { - message => q|Template, Add/Edit|, - lastUpdated => 1038890615 - }, - '15' => { message => q|January|, lastUpdated => 1031514049 @@ -450,11 +445,6 @@ The URL of the web site for this theme's designer. If you are in the business of lastUpdated => 1031514049 }, - '825' => { - message => q|Template, Language|, - lastUpdated => 1038865669 - }, - '917' => { message => q|Add a theme component.|, lastUpdated => 1050232824 @@ -633,11 +623,6 @@ Be aware that any database links you create here will be available to all conten lastUpdated => 1035246389 }, - '685' => { - message => q|Template, Delete|, - lastUpdated => 1038791020 - }, - '21' => { message => q|July|, lastUpdated => 1031514049 @@ -869,11 +854,6 @@ How should this user be notified when they get a new WebGUI message? lastUpdated => 1031514049 }, - '683' => { - message => q|Templates, Manage|, - lastUpdated => 1050430164 - }, - '444' => { message => q|Demographic Information|, lastUpdated => 1031514049 @@ -951,12 +931,6 @@ As with any delete operation, you are prompted to be sure you wish to proceed wi lastUpdated => 1031514049 }, - '638' => { - message => q|Templates are used to affect how content is laid out in WebGUI. There are many templates that come with WebGUI, and using the template management system, you can add your own templates to the system to ensure that your site looks exactly how you want it to look. -|, - lastUpdated => 1050430164 - }, - '734' => { message => q|5 Adept|, lastUpdated => 1033836678 @@ -2242,98 +2216,6 @@ http://www.mysite.com/thisPage#94 lastUpdated => 1051464113 }, - '826' => { - message => q|WebGUI has a powerful templating language built to give you maximum control over the layout of your content. -

NOTES:
-Both the template language and template variables are case-insensitive. -

-Session Variables
-In addition to any variables defined in a given template, of the session variables are made available to you with this syntax: -

- -<tmpl_var session.section.variable> - -

-In the examples below, please note that the words foo and bar are used as placeholders for the actual variable names that you'll use. They are not part of the template language. - -

-Variables
-Variables are the most basic of the template commands. They are used to position pieces of content. - -

-Syntax: <tmpl_var foo> or <tmpl_var name="foo"> -

- -Example: <tmpl_var name> -

- -Conditions
-To programmers conditions are nothing new, but to designers they can often be confusing at first. Conditions are really just true or false questions, and if you think of them that way, you'll have no trouble at all. -

- -Syntax: <tmpl_if foo> <tmpl_else> </tmpl_if> -
-Syntax: <tmpl_unless foo> <tmpl_else> </tmpl_unless> -

- -Example: <tmpl_if isTrue> It was true!<tmpl_else> It was false! </tmpl_if> -

- -

Truth or falsehood is determined by the following rules: -

- -Loops
-Loops iterate over a list of data output for each pass in the loop. Loops are slightly more complicated to use than plain variables, but are considerably more powerful. -

- -Syntax: <tmpl_loop foo> </tmpl_loop> -

- -Example:
-<tmpl_loop users>
-   Name: <tmpl_var first_name><br/>
-</tmpl_loop> -

- -Loop Conditions
-Loops come with special condition variables of their own. They are __FIRST__, __ODD__, __INNER__, and __LAST__. -

- -Examples:
-

-   <TMPL_LOOP FOO>
-      <TMPL_IF __FIRST__>
-        This only outputs on the first pass.
-      </TMPL_IF>
-
-      <TMPL_IF __ODD__>
-        This outputs every other pass, on the odd passes.
-      </TMPL_IF>
-
-      <TMPL_UNLESS __ODD__>
-        This outputs every other pass, on the even passes.
-      </TMPL_UNLESS>
-
-      <TMPL_IF __INNER__>
-        This outputs on passes that are neither first nor last.
-      </TMPL_IF>
-
-      <TMPL_IF __LAST__>
-        This only outputs on the last pass.
-      <TMPL_IF>
-   </TMPL_LOOP>
-
- -

|, - lastUpdated =>1106608811, - }, - '354' => { message => q|View Inbox.|, lastUpdated => 1031514049 @@ -3472,15 +3354,7 @@ The local path of the directory where attachments are to be stored. (Perhaps /va message => q|November|, lastUpdated => 1031514049 }, - - '640' => { - message => q|It is not a good idea to delete templates as you never know what kind of adverse affect it may have on your site (some content may still be using the template). -

- -|, - lastUpdated => 1038791020 - }, - + '738' => { message => q|9 Guru|, lastUpdated => 1033836704 @@ -4071,23 +3945,6 @@ You can search users based on username and email address. You can do partial sea lastUpdated => 1052850265 }, - '639' => { - message => q|Template Name
-Give this template a descriptive name so that you'll know what it is when you're applying a template to content. -

- -Namespace
-What type of template is this? -

- -Template
-Create your template by using template commands and variables, macros, and HTML. -

- -NOTE: You should never edit the default templates that come with WebGUI as they are subject to change with each new release. Instead, copy the template you wish to edit, and edit the copy.|, - lastUpdated => 1038890615 - }, - '989' => { message => q|on page|, lastUpdated => 1056151382