devot:eeDevoted to ExpressionEngine

This plugin allows you to output the value of a single custom field of a certain entry without using exp:weblog:entries or exp:channel:entries tag.

PARAMETERS

1) field - Required. Allows you to specify field name.

2) entry_id - Optional. Allows you to specify entry id number.

3) weblog (for EE1.x) - Optional. Allows you to specify weblog short name.

3) channel (for EE2.0 plus) - Optional. Allows you to specify channel short name.

5) url_title - Optional. Allows you to specify url_title.

Either “entry_id” or “weblog/channel” and “url_title” parameters must be defined.

6) field_format - Optional. Allows you to specify how field data should be
formatted. Possible values: “html”, “br”, “none”, “lite”, “raw”.
In case this parameter is left undefined, format info
will be retrieved from database. In case parameter’s value is “raw”,
data will be outputted without any format applied.

7) site - Optional. Allows you to specify site id number. Default is “1”.

8) invalid_input - Optional. Accepts two values: “alert” and “silence”.
Default value is “silence”. If the value is “alert”, then in cases when
the plugin has some problem with parameters,  PHP alert is being shown;
if the value is “silence”, then in cases when the plugin has
some problem with parameters, it finishes its work without any alert being shown.
Set this parameter to “alert” for development, and to “silence” - for deployment.

9) allow_img_url - Optional. Allow inline images? Possible values: “yes” and “no”.
If the value is not specified, then the value from channel’s preferences will be used.

10) auto_links - Optional. Auto-link URLs and email addresses? Possible values: “yes” and “no”.
(Note that auto-linking does not ever occur if parameter “html_format” is set to “none”.)
If the value is not specified, then the value from channel’s preferences will be used.

11) encode_email - Optional. Whether or not email addresses are encoded. Possible values: “yes” and “no”. Default is “yes”.

12) encode_type - Optional. Type of encoding applied to email addresses
if email address encoding is enabled. Possible values: “javascript ” and “noscript”.
“noscript” renders in a human readable format (e.g. “name at example dot com)”,
suitable for use where JavaScript is inappropriate, such as in a feed.

13) html_format - Optional. Controls how HTML is handled in text. Possible values: “safe”, “all”, “none”.
If the value is not specified, then the value from channel’s preferences will be used.

14) parse_smileys - Optional. Replace text smileys with smiley images? Possible values: “yes” and “no”. Default is “yes”.

15) field_is_date - Optional. Accepts two values: “yes” and “no”.
Default value is “no”. Set this parameter to “yes” in case custom field contains date.

16) date_format - Optional. Used in case “field_is_date” parameter is set to “yes”. Allows to specify ExpressionEngine’s
date format.

17) date_localize - Optional. Used in case “field_is_date” parameter is set to “yes”. Allows you to specify if the date
should be localized. Accepts two values: “yes” and “no”. Default value is “no”.

EXAMPLE OF USAGE

With “entry_id” parameter defined:

{exp:single_field  field="my_custom_field" entry_id="251" site="1" field_format="xhtml"}

With “weblog” and “url_title” parameters defined:

{exp:single_field  field="my_custom_field" weblog="my_weblog" url_title="my_blog_title" site="1" field_format="raw"}

Single Field Links

• Plugin: Single Field

This entry was last updated April 12, 2011, 3:08 am.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. Devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!