RecordAdmin cheatsheet

General forms code

http://wufoo.com/gallery

Content for Record Templates

EditWithForm

Use this to add an "edit with form" link to articles using the template (i.e. of the record type).

{{EditWithForm|Activity}}

Content for Record Forms

Show a section of the form based on a checkbox state

Often many parts of a form are only relevant depending on other values, for example a biiling address may only be shown if the "same as shipping address" check-box is not ticked.

In this example, we have added an onChange event to the checkbox which causes things to show/hide. Only two things even need to be changed in this statement, first the "BillingAddress" which defines the element that will be affected when the value changes, and second the order of the 'none' : '' can be switched if the tick should correspond to hidden state rather than shown as it currently does.

Next there is a div tag surrounding the area to be shown/hidden which must have an id attribute to be referred to by the checkbox's onChange event. Note that I have also added the style attribute that is used to ensure the form is initially in the correct state, it sets the style to display:none if the UseShipping value is set.

<input
    name     = "UseShipping"
    type     = "checkbox"
    onchange = "document.getElementById('BillingAddress').style.display=this.checked ? 'none' : ''"
/> Use shipping address

<div id="BillingAddress" style="{{{UseShipping|display:none}}}">
    Street: <input name="Street" />
    City:   <input name="City" />
</div>

Result

Use shipping address

Street: City:

Tooltips

{{Tooltip|label|content}}

is a tooltip example, mouse over it to see.

Select list examples

Select a Record

Selecting a record will have a special parser function made for it so that instead of passing a single record type, a list or tree of records can be supplied.

Forms use AJAX to render inline using a link
Link is red if an instance doesn't currently exist
Link works as a show/hide of form for single records, a tab-set for a list, or a tree-view for hierarchical lists
It's expected that this be the primary method of creating sub-forms, so there's no need to select from lists of records

<select name="Organisation">{{FormSelectRecord|Organisation|Organic Design}}</select>

Result

Populate options from a category

<select name="RecordType">{{FormSelectFromCategory|Records}}</select>

Result

Populate options from titles in a namespace

<select name="Cat">{{FormSelectFromNamespace|Category}}</select>

Result

Populate options using a DPL query

{{#tag:html|<select name="z-Articles">{{#dpl:titlematch=%z%|format = ,\n<option>%TITLE%</option>,, }}</select>}}

Result (all articles containing a "z")

Creation Links

Link to New Record

{{NewRecordLink|Create an issue...|Issue|Organisation|Organic Design|Project|RecordAdmin extension}}

Result

Create an issue...

Link to new article using preload

{{CreateWithPreload|Create a new Role...|My new role|Create:Role}}

Result

Create a new Role...

Article creation form with preload

<html>
	<form action="/wiki/index.php" method="GET">
		<input name="title" value="Enter title" />
		<input type="hidden" name="preload" value="Create:Role" />
		<input type="hidden" name="action" value="edit" />
		<input type="submit" value="Create!" />
	</form>
</html>

Result

Date and time

We're using date-picker-v2

MyDate:
    <select name="MyDay" id="date-sel-dd">{{SelectDay}}</select>
    <select name="MyMonth" id="date-sel-mm">{{SelectMonth}}</select>
    <select name="MyYear" class="split-date" id="date-sel">{{SelectYear}}</select>

Result

MyDate:

You can supply a parameter to use as a default if there's no current value, for example:

    <select name="MyDay">{{SelectDay|{{CURRENTDAY}}}}</select>

Following is a useful JavaScript function for setting default times in a form such as in Form:Activity. It sets the start time to the current local time if it's empty, and only sets the end time to the current time if the start time is already populated.

{{{1}}}

List of records

{{#recordtable:Issue
 | cols       = modified, title, AssignedTo
 | sortable   = yes
 | orderby    = created desc
 | Solution   = ^$
}}

See Category:Issues. This wiki text displays the list at the top of the page.

Financial

Obtaining Data

Obtain the value of a field from a given record

{{#recorddata:type=Person|record=Aran|field=Surname}}

Result: {{#recorddata:type=Person|record=Aran|field=Surname}}

Find a record given one or more field values

{{#recorddata:type=Person|Email=aran@organicdesign.co.nz}}

Result: {{#recorddata:type=Person|Email=aran@organicdesign.co.nz}}

UserFromPerson

Template:UserFromPerson

PersonFromUser

Template:PersonFromUser

Training

Set Up user accounts
add {{UserPage}} to User Pages
Show how to create tasks
Show how to edit/re-assign tasks
Show how to watch tasks
Show how to see tasks from user page