Tizra Help Manual Page 547 (547 of 549)

You can test for a variety of other contexts, including Browsers... %IF_CONTEXT_VALUE_BEGIN(BROWSER_TYPE,FIREFOX_MAC)%Message to Mac Firefox users here%IF_CONTEXT_VALUE_END% Browsers recognized are... FIREFOX_MAC -- Firefox on Mac OS FIREFOX -- Firefox on Windows IE -- Internet Explorer SAFARI -- Apple Safari CHROME -- Google Chrome OTHER -- Other than those above You can display a message dependent on the value of a metadata field for a given document on its Table of Contents, Title Content or Access Denied pages like this... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:field name,match value)%Your message here.%IF_CONTEXT_VALUE_END% For example, say you want to display a promotional message on Documents on which you've created a Yes/No field called "Special" and set it to Yes... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:Special,true)%Special promotional message here%IF_CONTEXT_VALUE_END% If you just wanted to display a message in cases where a certain metadata field exists at all, you could do it like this... %IF_CONTEXT_VALUE_BEGIN(METADATA_EXISTS,Authors)%There is an author field%IF_CONTEXT_VALUE_END% And on Access Deniedpages, you can display a specific message based on the reason why access was denied (helpful for error messages). For example, if you wanted to display a particular message to users who enter an incorrect username/password pair, you'd use something like... %IF_CONTEXT_VALUE_BEGIN(DENIED_REASON,6)%The username and password combination you have entered does not match our records.%IF_CONTEXT_VALUE_END% Other Access Denied reasons... 1 -- User is not authenticated 2 -- User is authenticated but has no content licenses 3 -- User is authenticated but has no license to the content they are trying to access 4 -- No username entered 5 -- No password entered 7 -- Account is not activated 8 -- Account has been cancelled

Previous Page Next Page

Downloaded from Tizra Support Resource Hub (support.tizra.com) by unknown.

Extracted Text (may have errors)

You can test for a variety of other contexts, including Browsers... %IF_CONTEXT_VALUE_BEGIN(BROWSER_TYPE,FIREFOX_MAC)%Message to Mac Firefox users here%IF_CONTEXT_VALUE_END% Browsers recognized are... FIREFOX_MAC -- Firefox on Mac OS FIREFOX -- Firefox on Windows IE -- Internet Explorer SAFARI -- Apple Safari CHROME -- Google Chrome OTHER -- Other than those above You can display a message dependent on the value of a metadata field for a given document on its Table of Contents, Title Content or Access Denied pages like this... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:field name,match value)%Your message here.%IF_CONTEXT_VALUE_END% For example, say you want to display a promotional message on Documents on which you've created a Yes/No field called "Special" and set it to Yes... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:Special,true)%Special promotional message here%IF_CONTEXT_VALUE_END% If you just wanted to display a message in cases where a certain metadata field exists at all, you could do it like this... %IF_CONTEXT_VALUE_BEGIN(METADATA_EXISTS,Authors)%There is an author field%IF_CONTEXT_VALUE_END% And on Access Deniedpages, you can display a specific message based on the reason why access was denied (helpful for error messages). For example, if you wanted to display a particular message to users who enter an incorrect username/password pair, you'd use something like... %IF_CONTEXT_VALUE_BEGIN(DENIED_REASON,6)%The username and password combination you have entered does not match our records.%IF_CONTEXT_VALUE_END% Other Access Denied reasons... 1 -- User is not authenticated 2 -- User is authenticated but has no content licenses 3 -- User is authenticated but has no license to the content they are trying to access 4 -- No username entered 5 -- No password entered 7 -- Account is not activated 8 -- Account has been cancelled

Help

Macros You can use macros to display various kinds of data in your pages. Inserting Metadata Values If you want to insert the Title, Author or any other metadata field in a document-specific Page Types, such as Document ToC, Title Content or Access Denied, use a macro in the following format... %TAG_VALUE_OBJECT(Name of Field,Value to Insert if Field is Empty)% For example, to insert a Document's Title... %TAG_VALUE_OBJECT(Title,)% Or Keywords... %TAG_VALUE_OBJECT(Keywords,)% Or to include the path to a cover image (from a field called "Cover") in an image call... img src="%TAG_VALUE_OBJECT(Cover,) Display Dependent on Context If you want a string to displayed only when certain conditions exist, you can use macros that test for a certain context, using the format... %IF_CONTEXT_VALUE_BEGIN(context name,match value)%Your code here%IF_CONTEXT_VALUE_END% For example, if you want display a message only to users who are logged in, you'd do something like... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,TRUE)%Message to logged in users here%IF_CONTEXT_VALUE_END% For example, if you want display a message only to users who are NOT logged in, you'd do something like... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,FALSE)% your text here %IF_CONTEXT_VALUE_END% in a free HTML block and the text will be displayed if user has not been logged in into the system. You can further narrow the users who will see the message to those logged in as members of a particular Account Set like this... %IF_USER_SET_BEGIN(UserSetName)%Congratulations! You are a member of this set.%IF_CONTEXT_VALUE_END%

Previous Page Next Page

Downloaded from Tizra Support Resource Hub (support.tizra.com) by unknown.

Extracted Text (may have errors)

Macros You can use macros to display various kinds of data in your pages. Inserting Metadata Values If you want to insert the Title, Author or any other metadata field in a document-specific Page Types, such as Document ToC, Title Content or Access Denied, use a macro in the following format... %TAG_VALUE_OBJECT(Name of Field,Value to Insert if Field is Empty)% For example, to insert a Document's Title... %TAG_VALUE_OBJECT(Title,)% Or Keywords... %TAG_VALUE_OBJECT(Keywords,)% Or to include the path to a cover image (from a field called "Cover") in an image call... img src="%TAG_VALUE_OBJECT(Cover,) Display Dependent on Context If you want a string to displayed only when certain conditions exist, you can use macros that test for a certain context, using the format... %IF_CONTEXT_VALUE_BEGIN(context name,match value)%Your code here%IF_CONTEXT_VALUE_END% For example, if you want display a message only to users who are logged in, you'd do something like... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,TRUE)%Message to logged in users here%IF_CONTEXT_VALUE_END% For example, if you want display a message only to users who are NOT logged in, you'd do something like... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,FALSE)% your text here %IF_CONTEXT_VALUE_END% in a free HTML block and the text will be displayed if user has not been logged in into the system. You can further narrow the users who will see the message to those logged in as members of a particular Account Set like this... %IF_USER_SET_BEGIN(UserSetName)%Congratulations! You are a member of this set.%IF_CONTEXT_VALUE_END%

If/Else Logic You can use if/else logic to display one thing if particular condition applies, and something else if it doesn't. Macro format... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:field name,match value)%Text you want to display if there is a match %IF_CONTEXT_VALUE_ELSE%Text you want to display if there isn't a match %IF_CONTEXT_VALUE_END% For example, if you want to display one message to users who are logged in, and another message to those who aren't, you'd use... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,TRUE)%Congratulations, you are logged in. %IF_CONTEXT_VALUE_ELSE%Please log in. %IF_CONTEXT_VALUE_END% Or if you want to display nothing if there is no value in the Cover field, but otherwise to display an image call containing that value... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:Cover,)% %IF_CONTEXT_VALUE_ELSE%img src="%TAG_VALUE_OBJECT(Cover,)%" %IF_CONTEXT_VALUE_END% This is useful if you want to display a cover image for those publications that have one...without generating a broken image call for those that don't. Using Macros to place a tag value from a title when designing a title's content page: You can add any meta tag value from the title containing the content page by placing the macro: %TAG_VALUE_PARENT_OBJECT(tag name,default value if not found)%. This will allow you to place in your title content pages (the PDF content pages) any metadata that is specific to the title the page belongs to. (Built in tag names, below.) Additional Macros %SITE_NAME%: the site's name as defined in admin Settings. %URL_TITLE_INDEX%: link to index of titles on the site starting with 'A'. %URL_TITLE_INDEX_ALL%: link to index of all titles on the site. %URL_AUTHOR_INDEX%: link to index of titles on the site indexed by author names starting with 'A'. %URL_AUTHOR_INDEX_ALL%: link to index of all titles on the site indexed by author names. %URL_SITE_ADMIN%: link to site's admin area. %URL_SITE_RSS%: link to site's RSS feed. %URL_SITE_USER_INFO%: link to current authenticated users information page. %URL_SITE_HOME%: link to site's homepage. %URL_CONTACT_US%: link to site's "contact us" page. %URL_SITE_INFO_TOS%: link to site's terms of service page. %URL_SITE_INFO_PP%: link to site's privacy policy page.

Previous Page Next Page

Downloaded from Tizra Support Resource Hub (support.tizra.com) by unknown.

Extracted Text (may have errors)

If/Else Logic You can use if/else logic to display one thing if particular condition applies, and something else if it doesn't. Macro format... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:field name,match value)%Text you want to display if there is a match %IF_CONTEXT_VALUE_ELSE%Text you want to display if there isn't a match %IF_CONTEXT_VALUE_END% For example, if you want to display one message to users who are logged in, and another message to those who aren't, you'd use... %IF_CONTEXT_VALUE_BEGIN(LOGGED_IN,TRUE)%Congratulations, you are logged in. %IF_CONTEXT_VALUE_ELSE%Please log in. %IF_CONTEXT_VALUE_END% Or if you want to display nothing if there is no value in the Cover field, but otherwise to display an image call containing that value... %IF_CONTEXT_VALUE_BEGIN(METADATA_VALUE:Cover,)% %IF_CONTEXT_VALUE_ELSE%img src="%TAG_VALUE_OBJECT(Cover,)%" %IF_CONTEXT_VALUE_END% This is useful if you want to display a cover image for those publications that have one...without generating a broken image call for those that don't. Using Macros to place a tag value from a title when designing a title's content page: You can add any meta tag value from the title containing the content page by placing the macro: %TAG_VALUE_PARENT_OBJECT(tag name,default value if not found)%. This will allow you to place in your title content pages (the PDF content pages) any metadata that is specific to the title the page belongs to. (Built in tag names, below.) Additional Macros %SITE_NAME%: the site's name as defined in admin Settings. %URL_TITLE_INDEX%: link to index of titles on the site starting with 'A'. %URL_TITLE_INDEX_ALL%: link to index of all titles on the site. %URL_AUTHOR_INDEX%: link to index of titles on the site indexed by author names starting with 'A'. %URL_AUTHOR_INDEX_ALL%: link to index of all titles on the site indexed by author names. %URL_SITE_ADMIN%: link to site's admin area. %URL_SITE_RSS%: link to site's RSS feed. %URL_SITE_USER_INFO%: link to current authenticated users information page. %URL_SITE_HOME%: link to site's homepage. %URL_CONTACT_US%: link to site's "contact us" page. %URL_SITE_INFO_TOS%: link to site's terms of service page. %URL_SITE_INFO_PP%: link to site's privacy policy page.

Page 2How to Use this Manual click to expand contents

Page 5Getting Started with Your Tizra Site click to expand contents

Page 32The Document Properties Screen click to expand contents

Page 85Excerpt Properties Screen click to expand contents

Page 109Documents and Excerpts How To Guide click to expand contents

Page 130Table of Contents How To Guide click to expand contents

Page 136The Offer Properties Screen click to expand contents

Page 169Offers How To Guide click to expand contents

Page 195The Collection Properties Screen click to expand contents

Page 221Collections How To Guide click to expand contents

Page 227Static Pages click to expand contents

Page 245Static Pages How To Guide click to expand contents

Page 250Individual User Account Screen click to expand contents

Page 264The Institutional User Account Screen click to expand contents

Page 279User Account Sets click to expand contents

Page 291Users How To Guide click to expand contents

Page 318General Guide to Content and Users Sections click to expand contents

Page 406Presentation click to expand contents

Page 437Presentation How To Guide click to expand contents

Page 479Reporting click to expand contents

Page 489Commerce click to expand contents

Page 495Settings click to expand contents

Page 498Glossary click to expand contents

Page 523Frequently Asked Questions click to expand contents

Page 533Appendix click to expand contents

Extracted Text (may have errors)

Help

loading

Extracted Text (may have errors)

Extracted Text (may have errors)