source-class-Mandrill_Metadata.html 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5. <meta name="generator" content="ApiGen 2.8.0" />
  6. <meta name="robots" content="noindex" />
  7. <title>File Mandrill/Metadata.php</title>
  8. <script type="text/javascript" src="resources/combined.js?394153670"></script>
  9. <script type="text/javascript" src="elementlist.js?882160656"></script>
  10. <link rel="stylesheet" type="text/css" media="all" href="resources/style.css?3505392360" />
  11. </head>
  12. <body>
  13. <div id="left">
  14. <div id="menu">
  15. <a href="index.html" title="Overview"><span>Overview</span></a>
  16. <div id="groups">
  17. <h3>Namespaces</h3>
  18. <ul>
  19. <li class="active"><a href="namespace-None.html">None</a>
  20. </li>
  21. <li><a href="namespace-PHP.html">PHP</a>
  22. </li>
  23. </ul>
  24. </div>
  25. <hr />
  26. <div id="elements">
  27. <h3>Classes</h3>
  28. <ul>
  29. <li><a href="class-Mandrill.html">Mandrill</a></li>
  30. <li><a href="class-Mandrill_Exports.html">Mandrill_Exports</a></li>
  31. <li><a href="class-Mandrill_Inbound.html">Mandrill_Inbound</a></li>
  32. <li><a href="class-Mandrill_Internal.html">Mandrill_Internal</a></li>
  33. <li><a href="class-Mandrill_Ips.html">Mandrill_Ips</a></li>
  34. <li><a href="class-Mandrill_Messages.html">Mandrill_Messages</a></li>
  35. <li class="active"><a href="class-Mandrill_Metadata.html">Mandrill_Metadata</a></li>
  36. <li><a href="class-Mandrill_Rejects.html">Mandrill_Rejects</a></li>
  37. <li><a href="class-Mandrill_Senders.html">Mandrill_Senders</a></li>
  38. <li><a href="class-Mandrill_Subaccounts.html">Mandrill_Subaccounts</a></li>
  39. <li><a href="class-Mandrill_Tags.html">Mandrill_Tags</a></li>
  40. <li><a href="class-Mandrill_Templates.html">Mandrill_Templates</a></li>
  41. <li><a href="class-Mandrill_Urls.html">Mandrill_Urls</a></li>
  42. <li><a href="class-Mandrill_Users.html">Mandrill_Users</a></li>
  43. <li><a href="class-Mandrill_Webhooks.html">Mandrill_Webhooks</a></li>
  44. <li><a href="class-Mandrill_Whitelists.html">Mandrill_Whitelists</a></li>
  45. </ul>
  46. <h3>Exceptions</h3>
  47. <ul>
  48. <li><a href="class-Mandrill_Error.html">Mandrill_Error</a></li>
  49. <li><a href="class-Mandrill_HttpError.html">Mandrill_HttpError</a></li>
  50. <li><a href="class-Mandrill_Invalid_CustomDNS.html">Mandrill_Invalid_CustomDNS</a></li>
  51. <li><a href="class-Mandrill_Invalid_CustomDNSPending.html">Mandrill_Invalid_CustomDNSPending</a></li>
  52. <li><a href="class-Mandrill_Invalid_DeleteDefaultPool.html">Mandrill_Invalid_DeleteDefaultPool</a></li>
  53. <li><a href="class-Mandrill_Invalid_DeleteNonEmptyPool.html">Mandrill_Invalid_DeleteNonEmptyPool</a></li>
  54. <li><a href="class-Mandrill_Invalid_EmptyDefaultPool.html">Mandrill_Invalid_EmptyDefaultPool</a></li>
  55. <li><a href="class-Mandrill_Invalid_Key.html">Mandrill_Invalid_Key</a></li>
  56. <li><a href="class-Mandrill_Invalid_Reject.html">Mandrill_Invalid_Reject</a></li>
  57. <li><a href="class-Mandrill_Invalid_Tag_Name.html">Mandrill_Invalid_Tag_Name</a></li>
  58. <li><a href="class-Mandrill_Invalid_Template.html">Mandrill_Invalid_Template</a></li>
  59. <li><a href="class-Mandrill_IP_ProvisionLimit.html">Mandrill_IP_ProvisionLimit</a></li>
  60. <li><a href="class-Mandrill_Metadata_FieldLimit.html">Mandrill_Metadata_FieldLimit</a></li>
  61. <li><a href="class-Mandrill_NoSendingHistory.html">Mandrill_NoSendingHistory</a></li>
  62. <li><a href="class-Mandrill_PaymentRequired.html">Mandrill_PaymentRequired</a></li>
  63. <li><a href="class-Mandrill_PoorReputation.html">Mandrill_PoorReputation</a></li>
  64. <li><a href="class-Mandrill_ServiceUnavailable.html">Mandrill_ServiceUnavailable</a></li>
  65. <li><a href="class-Mandrill_Unknown_Export.html">Mandrill_Unknown_Export</a></li>
  66. <li><a href="class-Mandrill_Unknown_InboundDomain.html">Mandrill_Unknown_InboundDomain</a></li>
  67. <li><a href="class-Mandrill_Unknown_InboundRoute.html">Mandrill_Unknown_InboundRoute</a></li>
  68. <li><a href="class-Mandrill_Unknown_IP.html">Mandrill_Unknown_IP</a></li>
  69. <li><a href="class-Mandrill_Unknown_Message.html">Mandrill_Unknown_Message</a></li>
  70. <li><a href="class-Mandrill_Unknown_MetadataField.html">Mandrill_Unknown_MetadataField</a></li>
  71. <li><a href="class-Mandrill_Unknown_Pool.html">Mandrill_Unknown_Pool</a></li>
  72. <li><a href="class-Mandrill_Unknown_Sender.html">Mandrill_Unknown_Sender</a></li>
  73. <li><a href="class-Mandrill_Unknown_Subaccount.html">Mandrill_Unknown_Subaccount</a></li>
  74. <li><a href="class-Mandrill_Unknown_Template.html">Mandrill_Unknown_Template</a></li>
  75. <li><a href="class-Mandrill_Unknown_TrackingDomain.html">Mandrill_Unknown_TrackingDomain</a></li>
  76. <li><a href="class-Mandrill_Unknown_Url.html">Mandrill_Unknown_Url</a></li>
  77. <li><a href="class-Mandrill_Unknown_Webhook.html">Mandrill_Unknown_Webhook</a></li>
  78. <li><a href="class-Mandrill_ValidationError.html">Mandrill_ValidationError</a></li>
  79. </ul>
  80. </div>
  81. </div>
  82. </div>
  83. <div id="splitter"></div>
  84. <div id="right">
  85. <div id="rightInner">
  86. <form id="search">
  87. <input type="hidden" name="cx" value="" />
  88. <input type="hidden" name="ie" value="UTF-8" />
  89. <input type="text" name="q" class="text" />
  90. <input type="submit" value="Search" />
  91. </form>
  92. <div id="navigation">
  93. <ul>
  94. <li>
  95. <a href="index.html" title="Overview"><span>Overview</span></a>
  96. </li>
  97. <li>
  98. <a href="namespace-None.html" title="Summary of None"><span>Namespace</span></a>
  99. </li>
  100. <li>
  101. <a href="class-Mandrill_Metadata.html" title="Summary of Mandrill_Metadata"><span>Class</span></a>
  102. </li>
  103. </ul>
  104. <ul>
  105. <li>
  106. <a href="tree.html" title="Tree view of classes, interfaces, traits and exceptions"><span>Tree</span></a>
  107. </li>
  108. </ul>
  109. <ul>
  110. </ul>
  111. </div>
  112. <pre><code><span id="1" class="l"><a class="l" href="#1"> 1: </a><span class="xlang">&lt;?php</span>
  113. </span><span id="2" class="l"><a class="l" href="#2"> 2: </a>
  114. </span><span id="3" class="l"><a class="l" href="#3"> 3: </a><span class="php-keyword1">class</span> <a id="Mandrill_Metadata" href="#Mandrill_Metadata">Mandrill_Metadata</a> {
  115. </span><span id="4" class="l"><a class="l" href="#4"> 4: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="___construct" href="#___construct">__construct</a>(Mandrill <span class="php-var">$master</span>) {
  116. </span><span id="5" class="l"><a class="l" href="#5"> 5: </a> <span class="php-var">$this</span>-&gt;master = <span class="php-var">$master</span>;
  117. </span><span id="6" class="l"><a class="l" href="#6"> 6: </a> }
  118. </span><span id="7" class="l"><a class="l" href="#7"> 7: </a>
  119. </span><span id="8" class="l"><a class="l" href="#8"> 8: </a> <span class="php-comment">/**
  120. </span></span><span id="9" class="l"><a class="l" href="#9"> 9: </a><span class="php-comment"> * Get the list of custom metadata fields indexed for the account.
  121. </span></span><span id="10" class="l"><a class="l" href="#10">10: </a><span class="php-comment"> * @return array the custom metadata fields for the account
  122. </span></span><span id="11" class="l"><a class="l" href="#11">11: </a><span class="php-comment"> * - return[] struct the individual custom metadata field info
  123. </span></span><span id="12" class="l"><a class="l" href="#12">12: </a><span class="php-comment"> * - name string the unique identifier of the metadata field to update
  124. </span></span><span id="13" class="l"><a class="l" href="#13">13: </a><span class="php-comment"> * - state string the current state of the metadata field, one of &quot;active&quot;, &quot;delete&quot;, or &quot;index&quot;
  125. </span></span><span id="14" class="l"><a class="l" href="#14">14: </a><span class="php-comment"> * - view_template string Mustache template to control how the metadata is rendered in your activity log
  126. </span></span><span id="15" class="l"><a class="l" href="#15">15: </a><span class="php-comment"> */</span>
  127. </span><span id="16" class="l"><a class="l" href="#16">16: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_getList" href="#_getList">getList</a>() {
  128. </span><span id="17" class="l"><a class="l" href="#17">17: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>();
  129. </span><span id="18" class="l"><a class="l" href="#18">18: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'metadata/list'</span>, <span class="php-var">$_params</span>);
  130. </span><span id="19" class="l"><a class="l" href="#19">19: </a> }
  131. </span><span id="20" class="l"><a class="l" href="#20">20: </a>
  132. </span><span id="21" class="l"><a class="l" href="#21">21: </a> <span class="php-comment">/**
  133. </span></span><span id="22" class="l"><a class="l" href="#22">22: </a><span class="php-comment"> * Add a new custom metadata field to be indexed for the account.
  134. </span></span><span id="23" class="l"><a class="l" href="#23">23: </a><span class="php-comment"> * @param string $name a unique identifier for the metadata field
  135. </span></span><span id="24" class="l"><a class="l" href="#24">24: </a><span class="php-comment"> * @param string $view_template optional Mustache template to control how the metadata is rendered in your activity log
  136. </span></span><span id="25" class="l"><a class="l" href="#25">25: </a><span class="php-comment"> * @return struct the information saved about the new metadata field
  137. </span></span><span id="26" class="l"><a class="l" href="#26">26: </a><span class="php-comment"> * - name string the unique identifier of the metadata field to update
  138. </span></span><span id="27" class="l"><a class="l" href="#27">27: </a><span class="php-comment"> * - state string the current state of the metadata field, one of &quot;active&quot;, &quot;delete&quot;, or &quot;index&quot;
  139. </span></span><span id="28" class="l"><a class="l" href="#28">28: </a><span class="php-comment"> * - view_template string Mustache template to control how the metadata is rendered in your activity log
  140. </span></span><span id="29" class="l"><a class="l" href="#29">29: </a><span class="php-comment"> */</span>
  141. </span><span id="30" class="l"><a class="l" href="#30">30: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_add" href="#_add">add</a>(<span class="php-var">$name</span>, <span class="php-var">$view_template</span>=<span class="php-keyword1">null</span>) {
  142. </span><span id="31" class="l"><a class="l" href="#31">31: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;name&quot;</span> =&gt; <span class="php-var">$name</span>, <span class="php-quote">&quot;view_template&quot;</span> =&gt; <span class="php-var">$view_template</span>);
  143. </span><span id="32" class="l"><a class="l" href="#32">32: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'metadata/add'</span>, <span class="php-var">$_params</span>);
  144. </span><span id="33" class="l"><a class="l" href="#33">33: </a> }
  145. </span><span id="34" class="l"><a class="l" href="#34">34: </a>
  146. </span><span id="35" class="l"><a class="l" href="#35">35: </a> <span class="php-comment">/**
  147. </span></span><span id="36" class="l"><a class="l" href="#36">36: </a><span class="php-comment"> * Update an existing custom metadata field.
  148. </span></span><span id="37" class="l"><a class="l" href="#37">37: </a><span class="php-comment"> * @param string $name the unique identifier of the metadata field to update
  149. </span></span><span id="38" class="l"><a class="l" href="#38">38: </a><span class="php-comment"> * @param string $view_template optional Mustache template to control how the metadata is rendered in your activity log
  150. </span></span><span id="39" class="l"><a class="l" href="#39">39: </a><span class="php-comment"> * @return struct the information for the updated metadata field
  151. </span></span><span id="40" class="l"><a class="l" href="#40">40: </a><span class="php-comment"> * - name string the unique identifier of the metadata field to update
  152. </span></span><span id="41" class="l"><a class="l" href="#41">41: </a><span class="php-comment"> * - state string the current state of the metadata field, one of &quot;active&quot;, &quot;delete&quot;, or &quot;index&quot;
  153. </span></span><span id="42" class="l"><a class="l" href="#42">42: </a><span class="php-comment"> * - view_template string Mustache template to control how the metadata is rendered in your activity log
  154. </span></span><span id="43" class="l"><a class="l" href="#43">43: </a><span class="php-comment"> */</span>
  155. </span><span id="44" class="l"><a class="l" href="#44">44: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <a id="_update" href="#_update">update</a>(<span class="php-var">$name</span>, <span class="php-var">$view_template</span>) {
  156. </span><span id="45" class="l"><a class="l" href="#45">45: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;name&quot;</span> =&gt; <span class="php-var">$name</span>, <span class="php-quote">&quot;view_template&quot;</span> =&gt; <span class="php-var">$view_template</span>);
  157. </span><span id="46" class="l"><a class="l" href="#46">46: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'metadata/update'</span>, <span class="php-var">$_params</span>);
  158. </span><span id="47" class="l"><a class="l" href="#47">47: </a> }
  159. </span><span id="48" class="l"><a class="l" href="#48">48: </a>
  160. </span><span id="49" class="l"><a class="l" href="#49">49: </a> <span class="php-comment">/**
  161. </span></span><span id="50" class="l"><a class="l" href="#50">50: </a><span class="php-comment"> * Delete an existing custom metadata field. Deletion isn't instataneous, and /metadata/list will continue to return the field until the asynchronous deletion process is complete.
  162. </span></span><span id="51" class="l"><a class="l" href="#51">51: </a><span class="php-comment"> * @param string $name the unique identifier of the metadata field to update
  163. </span></span><span id="52" class="l"><a class="l" href="#52">52: </a><span class="php-comment"> * @return struct the information for the deleted metadata field
  164. </span></span><span id="53" class="l"><a class="l" href="#53">53: </a><span class="php-comment"> * - name string the unique identifier of the metadata field to update
  165. </span></span><span id="54" class="l"><a class="l" href="#54">54: </a><span class="php-comment"> * - state string the current state of the metadata field, one of &quot;active&quot;, &quot;delete&quot;, or &quot;index&quot;
  166. </span></span><span id="55" class="l"><a class="l" href="#55">55: </a><span class="php-comment"> * - view_template string Mustache template to control how the metadata is rendered in your activity log
  167. </span></span><span id="56" class="l"><a class="l" href="#56">56: </a><span class="php-comment"> */</span>
  168. </span><span id="57" class="l"><a class="l" href="#57">57: </a> <span class="php-keyword1">public</span> <span class="php-keyword1">function</span> <span class="php-keyword2">delete</span>(<span class="php-var">$name</span>) {
  169. </span><span id="58" class="l"><a class="l" href="#58">58: </a> <span class="php-var">$_params</span> = <span class="php-keyword1">array</span>(<span class="php-quote">&quot;name&quot;</span> =&gt; <span class="php-var">$name</span>);
  170. </span><span id="59" class="l"><a class="l" href="#59">59: </a> <span class="php-keyword1">return</span> <span class="php-var">$this</span>-&gt;master-&gt;call(<span class="php-quote">'metadata/delete'</span>, <span class="php-var">$_params</span>);
  171. </span><span id="60" class="l"><a class="l" href="#60">60: </a> }
  172. </span><span id="61" class="l"><a class="l" href="#61">61: </a>
  173. </span><span id="62" class="l"><a class="l" href="#62">62: </a>}
  174. </span><span id="63" class="l"><a class="l" href="#63">63: </a>
  175. </span><span id="64" class="l"><a class="l" href="#64">64: </a>
  176. </span><span id="65" class="l"><a class="l" href="#65">65: </a></span></code></pre>
  177. <div id="footer">
  178. API documentation generated by <a href="http://apigen.org">ApiGen 2.8.0</a>
  179. </div>
  180. </div>
  181. </div>
  182. </body>
  183. </html>