Facebook Cookbook - Jay Goldman [77]
int
N/A
Maximum number of characters to allow in the field.
fb:editor-textarea
The fb:editor-textarea tag is equivalent to an HTML textarea. Its parameters are listed in Table 6-12. You can use this tag in either the self-closed or open modes, depending on whether you want to include content or not. For example:
or:
Put your comments in here
Table 6-12. Parameters for fb:editor-textarea
Name
Type
Default value
Description
label
string
N/A
Label to display in the label column.
name
string
N/A
Name of the control, which will become the variable containing the value in the POST.
rows
int
N/A
Height of the text area in rows.
fb:editor-time
The fb:editor-time tag creates a series of selects with options for setting the hours, minutes, and a.m./p.m. values for a time field. Its parameters are listed in Table 6-13.
Table 6-13. Parameters for fb:editor-time
Name
Type
Default value
Description
label
string
N/A
Label to display in the label column.
name
string
N/A
Name of the control, which will be prepended to _hour, _min, and _ampm to create the variables containing the values in the POST (e.g., if you set this to “current”, you’ll get current_hour, current_min, and current_ampm in POST).
value
int
4:00 p.m.
The time in epoch seconds. See Formatting Relative Time for a description of epoch seconds and how to work with them.
fb:editor-month
The fb:editor-month tag creates a single select to pick a month of the year. Its parameters are listed in Table 6-14.
Table 6-14. Parameters for fb:editor-month
Name
Type
Default value
Description
label
string
N/A
Label to display in the label column.
name
string
N/A
Name of the control, which will become the variable containing the value in the POST.
value
int
“Month:”
Number of the month to select by default (January=1, and so on). If you don’t specify a value, this will default to the text “Month:”, which appears as the first option in the select and prompts users to make a choice.
fb:editor-date
The fb:editor-date tag creates two selects to pick the month and day of the year. Its parameters are listed in Table 6-15.
Table 6-15. Parameters for fb:editor-date
Name
Type
Default value
Description
label
string
N/A
Label to display in the label column.
name
string
N/A
Name of the control, which will be prepended to _month and _day to create the two variables containing the values in the POST (e.g., if you set this to “current”, you’ll get current_month and current_day in the POST).
value
int
“Month:”
Number of the month to select by default (January = 1, and so on). If you don’t specify a value, this will default to the text “Month:”, which appears as the first option in the select and prompts users to make a choice.
fb:editor-button
The fb:editor-button tag, which should appear inside an fb:editor-buttonset tag, renders a Facebook-style submit button. Its parameters are listed in Table 6-16.
Table 6-16. Parameters for fb:editor-button
Name
Type
Default value
Description
value
string
N/A
Text to display on the button. This is the only required field.
name
string
N/A
Name of the control, which will become the variable containing the value in the POST.
Heads Up! Heading Your App Pages
Problem
I want to display my app’s icon and a title at the top of my pages.
Solution
Use the fb:header tag:
which will give you your app’s icon and name, as shown in Figure 6-19.
Figure 6-19. Empty fb:header tag
You can also put text in the tag:
which will keep the icon but substitute your text for your app’s name, as shown in Figure 6-20.
Figure 6-20. fb:header with text
Discussion
You can pass in a false value for icon to switch off the icon display:
You can