Merge pull request #156 from gsteel/headmeta-itemprop

Add @method annotations for setItemprop and update docs to include them

Author: weierophinney

doc/book/helpers/head-meta.md

@@ -125,3 +125,21 @@ echo $this->headMeta();
 //   <meta property="og:title" content="my article title" />
 //   <meta property="og:type" content="article" />
 ```
+
+## Usage with HTML5 doctype
+
+Enabling the HTML5 doctype with the [Doctype helper](doctype.md) enables the use
+of the `itemprop` attribute (in addition to the standard `name` and
+`http-equiv`) with `HeadMeta`.  This is typically used to add
+[Microdata](https://schema.org) to the head of your document.
+
+```php
+$this->doctype(Zend\View\Helper\Doctype::HTML5);
+$this->headMeta()->setItemprop('headline', 'My Article Headline');
+$this->headMeta()->setItemprop('dateCreated', $date->format('c'));
+echo $this->headMeta();
+
+// output is:
+//   <meta itemprop="headline" content="My Article Headline">
+//   <meta itemprop="dateCreated" content="2018-07-12T22:19:06+00:00">
+``` 

src/Helper/HeadMeta.php

@@ -31,6 +31,10 @@
  * @method HeadMeta offsetGetProperty($index, $keyValue, $content, $modifiers = array())
  * @method HeadMeta prependProperty($keyValue, $content, $modifiers = array())
  * @method HeadMeta setProperty($keyValue, $content, $modifiers = array())
+ * @method HeadMeta appendItemprop($keyValue, $content, $modifiers = array())
+ * @method HeadMeta offsetGetItemprop($index, $keyValue, $content, $modifiers = array())
+ * @method HeadMeta prependItemprop($keyValue, $content, $modifiers = array())
+ * @method HeadMeta setItemprop($keyValue, $content, $modifiers = array())
  */
 class HeadMeta extends Placeholder\Container\AbstractStandalone
 {