Zend Framework: Zend_View_Helper_HeadBase Component Proposal

Table of Contents

1. Overview

Zend_View_Helper_HeadBase is used to generate an HTML base tag, taking into consideration doctype, server address and base URL.

2. References

http://www.w3.org/TR/html401/struct/links.html#h-12.4

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will generate valid HTML or XHTML depending on chosen doctype.
• This component will generate a valid, default base href consisting of protocol, domain, port and base path when no href is provided.
• This component will add a trailing forward slash to generated href attributes if the address is not a file (identified by absence of a "." character in href's basename).

4. Dependencies on Other Framework Components

• Zend_View_Helper_HtmlElement
• Zend_View_Helper_ServerUrl
• Zend_View_Helper_BaseUrl

5. Theory of Operation

The component is a view helper that renders an HTML <base> tag, conforming to doctype specified using the Zend_View_Helper_Doctype helper.

An "href" attribute may be passed to the helper but in its absence, one is generated based on information from the Zend_View_Helper_ServerUrl and Zend_View_Helper_BaseUrl helpers.

An optional "target" attribute may also be passed to the helper.

6. Milestones / Tasks

• Milestone 1: [DONE] Proposal finished
• Milestone 2: Proposal accepted
• Milestone 2: Working prototype checked into the incubator supporting use cases #1, #2, ...
• Milestone 3: Working prototype checked into the incubator supporting use cases #3 and #4.
• Milestone 4: Unit tests exist, work, and are checked into SVN.
• Milestone 5: Initial documentation exists.

7. Class Index

• Zend_View_Helper_HeadBase

8. Use Cases

9. Class Skeletons