New Placeholder Development

Definition: A placeholder shows up as an icon in the xstandard editor and can be inserted into a document. This placeholder is replaced on render with current target of the placeholder, taking into account the attributes set (which could include layout, range, style, security, and elements requested)

when pages render, the regular expression searches for placeholders, if it finds them, it calls the replace method.

The "TITLE" attribute in <Placeholders_placeholdername.... /> is used by xstandard to draw the mouseover tooltip on the icon. therefore, placeholders should NOT have 'title' attributes because the key will not draw in the 'properties' box.

How to add a new placeholder placeholder

1. edit /!nclude/tools/XStandard/placeholders.xml to include an icon for new placeholder
2. edit /!nclude/tools/XStandard/webservices/directory.config and at the bottom put in a new placeholder in the format Directory.AddObject "FORM", "<placeholder_form title=""Form"" formname=""Test"" />", "certificate" 'FORMS (where certificate was the name of the chosen icon)
3. edit /!nclude/placeholder_engine.asp and put in the placeholder case statement what to do with your placeholder by chosen name (the more complicated placeholders are handled with external .asp included files, the simpler ones are handled directly in placeholder_engine.asp)
4. create an asp for the function named /!nclude/placeholder_chosenname.asp
5. update /!nclude/engine_include.asp to including the function file by name.
6. follow existing files examples and properly name the internal function and consume the settings for the placeholder in the case statement. xstandard 1.7 the <p> tags will not be auto inserted around the placeholder (or we have an option to disallow)
7. review /!nclude/webpage_functions.asp DrawConditionalJSPostProcess() to determine if an additional JavaScript needs to be added.