{"id":71517,"date":"2017-07-20T20:27:02","date_gmt":"2017-07-20T20:27:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/secretary\/"},"modified":"2022-01-29T12:46:49","modified_gmt":"2022-01-29T12:46:49","slug":"secretary","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/secretary\/","author":14506115,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.3","stable_tag":"trunk","tested":"5.9.13","requires":"","requires_php":"","requires_plugins":"","header_name":"Secretary","header_author":"ChrisBAshton","header_description":"Automatic quality-assurance checks, ensuring your articles meet editorial guidelines.","assets_banners_color":"efdfcd","last_updated":"2022-01-29 12:46:49","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/twitter.com\/ChrisBAshton","header_plugin_uri":"","header_author_uri":"http:\/\/ashton.codes","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1379,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"ChrisBAshton","date":"2017-07-20 20:29:05"},"1.0.1":{"tag":"1.0.1","author":"ChrisBAshton","date":"2021-02-20 13:59:10"},"1.0.2":{"tag":"1.0.2","author":"ChrisBAshton","date":"2022-01-29 12:34:24"},"1.0.3":{"tag":"1.0.3","author":"ChrisBAshton","date":"2022-01-29 12:36:53"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2668762,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2668762,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2668762,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2668762,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":2668762,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2668762,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":2668762,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":2668762,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Secretary warns you against common problems; in this case, the Featured Image set for the post was too large in filesize.","2":"Secretary will only look for the rules you tell it to look for. There are a few built into the Secretary plugin, but you can install other plugins which define other rules.","3":"The <code>HTML Checker<\/code> rule searches for HTML to warn your content editors that this is a brittle way of styling posts.","4":"If all is well, you should see all green ticks!"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1786,7615,9014,144132,7335],"plugin_category":[],"plugin_contributors":[144133],"plugin_business_model":[],"class_list":["post-71517","plugin","type-plugin","status-publish","hentry","plugin_tags-check","plugin_tags-qa","plugin_tags-quality","plugin_tags-secretary","plugin_tags-validate","plugin_contributors-chrisbashton","plugin_committers-chrisbashton"],"banners":{"banner":"https:\/\/ps.w.org\/secretary\/assets\/banner-772x250.png?rev=2668762","banner_2x":"https:\/\/ps.w.org\/secretary\/assets\/banner-1544x500.png?rev=2668762","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/secretary\/assets\/icon-128x128.png?rev=2668762","icon_2x":"https:\/\/ps.w.org\/secretary\/assets\/icon-256x256.png?rev=2668762","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/secretary\/assets\/screenshot-1.jpg?rev=2668762","caption":"Secretary warns you against common problems; in this case, the Featured Image set for the post was too large in filesize."},{"src":"https:\/\/ps.w.org\/secretary\/assets\/screenshot-2.png?rev=2668762","caption":"Secretary will only look for the rules you tell it to look for. There are a few built into the Secretary plugin, but you can install other plugins which define other rules."},{"src":"https:\/\/ps.w.org\/secretary\/assets\/screenshot-3.jpg?rev=2668762","caption":"The <code>HTML Checker<\/code> rule searches for HTML to warn your content editors that this is a brittle way of styling posts."},{"src":"https:\/\/ps.w.org\/secretary\/assets\/screenshot-4.jpg?rev=2668762","caption":"If all is well, you should see all green ticks!"}],"raw_content":"<!--section=description-->\n<p>Users define their editorial rules in YAML (see Settings -&gt; Secretary) according to a number of built-in rule functions. For example, Secretary can show a warning if you've forgotten to set a Featured Image for your post, by adding the <code>featured-image<\/code> rule to your YAML config.<\/p>\n\n<p>Secretary comes with a number of rules out of the box, but you can write your own custom plugins for Secretary by calling <code>SecretaryRules::register<\/code>. See example at https:\/\/github.com\/ChrisBAshton\/secretary-rule-gallery-at-top, and API documentation at https:\/\/github.com\/ChrisBAshton\/secretary.<\/p>\n\n<h3>Contact<\/h3>\n\n<p>If you spot any issues, or want to know how to contribute, please visit https:\/\/github.com\/ChrisBAshton\/secretary.<\/p>\n\n<p>Please note that I have open-sourced this plugin to give back to the community, and do not have much spare time to answer support queries, but I'll help where I can.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install the plugin through the WordPress plugins screen directly<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<li>Use the Settings-&gt;Secretary screen to configure the plugin (you can see all available rule configs on the right hand side of the screen)<\/li>\n<\/ol>\n\n<p>Example YAML config below:<\/p>\n\n<pre><code>categories:\n    not:\n        - Uncategorized\n    not-only:\n        - Featured\n\nfeatured-image:\n    max-size: 100\n    format: jpg\n    dimensions:\n        width: 760\n        height: 350\n\nexcerpt:\n    min-length: 30\n    max-length: 300\n\nscheduled:\n    publish-time: '15:00'\n\nlinks:\n    internal:\n        open-in-new-tab: false\n    external:\n        open-in-new-tab: true\n\nimages:\n    true\n\nhtml-checker:\n    risky-html:\n      - table\n      - div\n      - span\n      - style\n      - script\n<\/code><\/pre>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20do%20i%20know%20what%20rules%20are%20available%3F'><h3>How do I know what rules are available?<\/h3><\/dt>\n<dd><p>Look at the right hand side of the screen under Settings -&gt; Secretary.<\/p><\/dd>\n<dt id='i%27m%20getting%20a%20%60config%20error%3A%20no%20such%20rule%21%60'><h3>I'm getting a `Config error: no such rule!`<\/h3><\/dt>\n<dd><p>If you see something like:<\/p>\n\n<pre><code>\u274c foo\nConfig error: no such rule!\n<\/code><\/pre>\n\n<p>...it means you have asked Secretary to apply a rule which does not exist. Check your spelling.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Removes an accidentally committed internal-facing README file<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Removed unneeded 'assets\/' directory<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Tested with Gutenberg<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Automatic quality-assurance checks, ensuring your articles meet editorial guidelines.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/71517","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=71517"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/chrisbashton"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=71517"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=71517"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=71517"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=71517"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=71517"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=71517"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}