Code Editor

Protopage blog Protopage

Viewer Tools

View Authors' Profile »

Method Navigation

Aip First version 0.1 by Mihai Antispo

Code is Read-Only HTML / Javascript Widget Attributes Widget Details Diff

This section of the Widget IDE lets you design the screen that users will see then they hit "edit" on the widget in their protopage. When a user loads this widget, these widget attributes will be substituted into the HTML / Javascript where template syntax has been used. For example, if you have <div>$username</div> in your HTML, and the widget has an attribute called "username" that is set to "Max", then at runtime, the HTML will be displayed as <div>Max</div>. If you have the "Use source URL" checkbox ticked in the "Widget Details" tab, then these widget parameters will be instead sent as GET / POST parameters when the source URL is invoked.

» Add new widget attribute... ?

Allows you to add a configuration field to the designer. Your users will see the fields when they click "edit" on their running widget and you will be able to access their values through your javascript code.

Choose attribute type: » Add » Cancel ?

Choose the type of configuration field you need and then click Add.
Checkbox: Provides a checkbox that the user may tick.
Hidden Attribute: A config value you can access in code but the user can't see.
Option Group: Provides the user with a list of options.
Table: Provides you the ability to group Checkboxes and Text Fields together into a table.
Text Field: Provides the user a free text box to type in.

Default width:	? Specifies the default width your widget will take up when a user first adds it to their Protopage.
Default height:	? Specifies the default height your widget will take up when a user first adds it to their Protopage.
Default title:	? Specifies the default title of the panel your widget will run in on the users' Protopage.
Use Source URL:	? Enables the use of the 'Source URL' specified below.
Source URL:	? If specified (and enabled above) the Source URL specifies a URL which will become the contents of the widget - the HTML / Javascript will be ignored in this case.
Vertical offset:	? You can increase this value to crop out the top part of the web page displayed.
Horizontal offset:	? You can increase this value to crop out the left part of the web page displayed.
Disable scrollbars:	? If the web page is larger than the size of your widget, scrollbars will normally be displayed. Tick this box to prevent scrollbars from appearing.
Send widget attributes as:	GET parameters POST parameters ? Widget attributes will be sent as GET / POST parameters to the source URL when this widget is loaded by a user.
Send unique user identifier:	? If the Source URL web page needs to keep track of user state, then it will need to have a way of uniquely identifying a returning user. If you tick this box, a cryptographically secure id token will be sent to the Source URL as a GET/POST parameter named "protopageUserToken". For privacy reasons this token will not identify any user personally nor the Protopage they own. The token will be a string of no more than 255 characters in length.

The HTML/Javascript tab has been disabled because when the 'Source URL' field is active all the content for the widget comes from the specified URL.

Show a diff between the HTML / Javascript being edited and version:

Create annotation...

Annotating code fragment: