{"id":59,"date":"2015-11-24T17:49:44","date_gmt":"2015-11-24T17:49:44","guid":{"rendered":"http:\/\/o-calcpro.com\/wiki\/?p=59"},"modified":"2015-11-24T17:49:44","modified_gmt":"2015-11-24T17:49:44","slug":"token-substitution-helper","status":"publish","type":"post","link":"http:\/\/o-calcpro.com\/wiki\/2015\/11\/24\/token-substitution-helper\/","title":{"rendered":"Token substitution helper"},"content":{"rendered":"

When creating scripts and plugins it is sometimes convenient to be able to process a tokenized template and fill in selected values from calculated values or form attributes on the structure.<\/p>\n

Some examples of this is the default file name template that allows the user to format the default file name of a PPLX file, and canned messages created by the Slack integration plugin.<\/p>\n

If you want to incorporate this functionality into your plugins or scripts there are two helper methods to assist you.<\/p>\n

\n\n\t\t
\n\n\t\t
\n\t\t\t\t\t\t< View plain text<\/span> ><\/a>\n\t\t\t\t\t<\/div>\n\n\t\t
C#<\/div>\n\n\t\t\n\t\t
\n\n\t<\/div>\n\t\n\t
\n\t\t
  1. public<\/span> String<\/span> ReplaceTokens(<\/span>String<\/span> pInput)<\/span>...<\/span><\/div><\/li>\n<\/ol>\t<\/div>\n\n<\/div>\n\n

    The replace tokens method replaces the standardized tokens (for example “%USER_NAME% is working on %Pole_ID%”) with the actual values for the currently loaded and calculated pole.<\/p>\n

    \n\n\t\t
    \n\n\t\t
    \n\t\t\t\t\t\t< View plain text<\/span> ><\/a>\n\t\t\t\t\t<\/div>\n\n\t\t
    C#<\/div>\n\n\t\t\n\t\t
    \n\n\t<\/div>\n\t\n\t
    \n\t\t
    1. public<\/span> void<\/span> DisplayTokensHelp(<\/span>)<\/span>...<\/span><\/div><\/li>\n<\/ol>\t<\/div>\n\n<\/div>\n\n

      This method displays a help file with all of the implemented tokens.<\/p>\n\"Facebook\"<\/a>\"twitter\"<\/a>\"linkedin\"<\/a>\"mail\"<\/a>","protected":false},"excerpt":{"rendered":"

      When creating scripts and plugins it is sometimes convenient to be able to process a tokenized template and fill in selected values from calculated values or form attributes on the structure. Some examples of this is the default file name template that allows the user to format the default file name of a PPLX file, ..<\/p>\n

      <\/div>\n

      Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,3],"tags":[],"class_list":["post-59","post","type-post","status-publish","format-standard","hentry","category-plugin-development","category-scripting"],"_links":{"self":[{"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/posts\/59","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/comments?post=59"}],"version-history":[{"count":3,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/posts\/59\/revisions"}],"predecessor-version":[{"id":62,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/posts\/59\/revisions\/62"}],"wp:attachment":[{"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/media?parent=59"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/categories?post=59"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/o-calcpro.com\/wiki\/wp-json\/wp\/v2\/tags?post=59"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}