English
资源说明：[Symphony 2] A field that allows embedding of HTML directly into the backend
# HTML Panel Field
## Purpose
To allow the creation of rich views of data in the Symphony backend, using only Symphony's native tools (Pages, XSLT and Data Sources). To reduce the barrier to entry of embedding of content within the Symphony backend without so that developers do not experience of creating Extensions and system Fields. "So easy a frontend developer could do it!"
## Installation
1. Upload the 'html_panel' folder in this archive to your Symphony 'extensions' folder
2. Enable it by selecting the "Field: HTML Panel", choose Enable from the with-selected menu, then click Apply
3. The field will be available in the list when creating a Section
## Configuration
When adding this field to a section you must provide a **URL Expression**. This is the URL of the HTML to display in the backend. This can be relative such as `/my-page` or absolute e.g. `http://mydomain.com/my-page`. Values from other fields in the entry can be used to build the URL and are included using XSLT syntax:
/order-summary-panel/{entry/@id}
The available XML to choose from is a full `` nodeset, as you would normally see through a Data Source. All fields are included in this XML.
## Example of use
This is a quick example to show how an HTML Panel field can be used to display an order summary from a one-to-many section relationship between Orders and Order Items.
The Orders section comprises a Name (reference) and Date field:
Entries in the Order Items section store the item name, unit price, quantity and which Order they are assigned to:
Viewing the Orders section a user sees the normal fields plus an HTML Panel field showing the order summary:
The HTML Panel field is configured to point to a local Symphony page, passing the viewed (Order) entry ID in the URL:
The order summary table is actually served from a frontend page with a Data Source attached, filtering Order Entries by the URL Parameter `{$order}`:
The XSLT for this page simply creates an HTML table and nothing else:
Item
Quantity
Unit Price
Total
£
£
## Styling HTML Panels
The extension provides a single `html-panel.css` which controls global styling of content within HTML Panel fields. Any custom styling should **not** be put in this file. Instead, each HTML Panel instance is given its own unique ID. For example an HTML Panel field named "Order Summary" in a section named "Orders" will render an HTML container:
...
You can create styles and behaviour by creating files at the following locations:
/workspace/html-panel/orders_order-summary.css
/workspace/html-panel/orders_order-summary.js
If these files exist, they will be automatically added to the `` when the page loads. Your CSS can then target its specific HTML Panel:
#orders_order-summary {
...
}
## Fields that store values
The above example is read-only — it just displays something. As of v1.2 HTML Panel can be used to build fields that store values too! You don't need to do anything too fancy. Start by passing the field's value in the URL to the page that builds the panel:
/my-page/?value={entry/my-field-name/text()}
In your XSLT you can then grab this value and build an input element. So long as you give the input element a name that matches your field name, its value will be saved to the entry. For example:
## A word on security
As [michael-e points out](http://symphony-cms.com/discuss/thread/40332/#position-6) the above example is rather insecure if you are actually displaying order information on a public URL. You should test in XSLT for the existence of a `$cookie-username` parameter (your Symphony author username), or use the [Login Info event](http://github.com/symphony/workspace/blob/master/events/event.login.php) attached to your page to get more information about the user. An even better option is to pass a known parameter on the querystring such as `?password=mypass` and test for _this_ in XSLT.
## Other uses
Use your imagination:
* allowing the user to enter a YouTube video URL in a text input field, and embedding it directly with an HTML Panel in the backend as a preview
* when multiple Images are assigned to an Article, an HTML Panel could display a read-only list of thumbnails with "Edit" links directly to these entries in the Images section (a type of read-only Subsection Manager field)
* when viewing a user profile, pull in a list of their most recent orders, posts or comments for review. Perhaps if you're building a moderation system, you pull in all un-moderated comments for a post
* embedding Google Charts or Google Maps
* making web service calls to third party application such as Google Analytics, stock/inventory/fulfilment systems etc
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
