First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3724770,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3724770,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3724770,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3724770,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3724770,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"ghostlabs\/perennial":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"ghostlabs\/perennial","version":"1.0.0","title":"Perennial: Copyright Notice","category":"widgets","icon":"editor-paragraph","description":"A copyright notice that keeps its year and site name current automatically.","keywords":["copyright","footer","year","legal"],"example":{},"attributes":{"from":{"type":"string","default":""},"owner":{"type":"string","default":""},"statementOfRights":{"type":"boolean","default":false},"yearColor":{"type":"string"},"customYearColor":{"type":"string"},"yearFontSize":{"type":"string"},"customYearFontSize":{"type":"string"},"yearFontWeight":{"type":"string"}},"supports":{"html":false,"align":true,"color":{"text":true,"background":true,"link":true},"spacing":{"margin":true,"padding":true},"typography":{"fontSize":true,"lineHeight":true}},"textdomain":"ghostlabs-dynamic-copyright-notice","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3724770,"resolution":"1","location":"assets","locale":"","width":2880,"height":1800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3724770,"resolution":"2","location":"assets","locale":"","width":2880,"height":1800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3724770,"resolution":"3","location":"assets","locale":"","width":2880,"height":1800},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3724770,"resolution":"4","location":"assets","locale":"","width":2880,"height":1800}},"screenshots":{"1":"The rendered notice in a site footer. The year is worked out when the page is served, so it turns over on 1 January by itself \u2014 nothing is stored in your content.","2":"Set a start year and the notice reads as a range \u2014 \u00a9 2016 \u2013 2026 \u2014 with the end always the current year. The Statement of rights toggle appends \"All rights reserved.\", punctuated for you.","3":"The year and its \u00a9 symbol get their own size, weight and color, set separately from the rest of the line \u2014 so it can carry the footer without the notice shouting.","4":"Add it once to your block theme's footer template part in the Site Editor, and every page that uses that footer carries the notice."}},"plugin_section":[],"plugin_tags":[2972,9796,140685,2640,523],"plugin_category":[],"plugin_contributors":[242362],"plugin_business_model":[],"class_list":["post-371651","plugin","type-plugin","status-publish","hentry","plugin_tags-copyright","plugin_tags-copyright-year","plugin_tags-current-year","plugin_tags-footer","plugin_tags-year","plugin_contributors-ghostlabs","plugin_committers-ghostlabs"],"banners":{"banner":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/banner-772x250.png?rev=3724770","banner_2x":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/banner-1544x500.png?rev=3724770","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/icon.svg?rev=3724770","icon":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/icon.svg?rev=3724770","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/screenshot-1.png?rev=3724770","caption":"The rendered notice in a site footer. The year is worked out when the page is served, so it turns over on 1 January by itself \u2014 nothing is stored in your content."},{"src":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/screenshot-2.png?rev=3724770","caption":"Set a start year and the notice reads as a range \u2014 \u00a9 2016 \u2013 2026 \u2014 with the end always the current year. The Statement of rights toggle appends \"All rights reserved.\", punctuated for you."},{"src":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/screenshot-3.png?rev=3724770","caption":"The year and its \u00a9 symbol get their own size, weight and color, set separately from the rest of the line \u2014 so it can carry the footer without the notice shouting."},{"src":"https:\/\/ps.w.org\/ghostlabs-dynamic-copyright-notice\/assets\/screenshot-4.png?rev=3724770","caption":"Add it once to your block theme's footer template part in the Site Editor, and every page that uses that footer carries the notice."}],"raw_content":"\n
Every site has a copyright line in the footer, and every site eventually has the wrong one \u2014\nbecause the year was typed in by hand and nobody remembered to change it.<\/p>\n\n
This plugin adds a single block that works the year out when the page is served, so the notice\nis right on 1 January without anyone touching it.<\/p>\n\n
What it does<\/strong><\/p>\n\n Built to stay correct<\/strong><\/p>\n\n The notice is rendered on the server, which matters more than it sounds:<\/p>\n\n The one thing server rendering cannot fix is somebody else's copy of the finished page. So when\nthe year turns over, the plugin clears the cache for you on WP Rocket, W3 Total Cache, WP Super\nCache and LiteSpeed Cache<\/strong> \u2014 those four. Any other cache can clear itself by hooking the rollover\naction; see the FAQ.<\/p>\n\n Alignment, color, spacing, font size and line height all come from the standard WordPress block\ncontrols, so the notice inherits your theme's palette and type scale rather than fighting it.<\/p>\n\n This plugin contacts no external services. It makes no network requests of any kind \u2014 no license\ncheck, no update check of its own, no analytics, no telemetry, no remote fonts or assets. Nothing\nabout your site or your visitors leaves your server because of it.<\/p>\n\n The one thing that might look like an exception is not one. When the year turns over the plugin\nclears the cache for WP Rocket, W3 Total Cache, WP Super Cache and LiteSpeed Cache \u2014 but it does\nthat by calling those plugins in PHP on your own site, if they happen to be installed. That is a\nfunction call inside WordPress, not a request to anybody.<\/p>\n\n The editor JavaScript this plugin ships is compiled. The sources it is compiled from are\npublished here, tagged to match each release:<\/p>\n\n https:\/\/github.com\/theghostlab\/wp-ghostlabs-perennial<\/p>\n\n That repository holds the plugin exactly as distributed, plus the The bundle that ships inside the plugin is minified, which is the whole reason that repository\nexists: the readable source is published there rather than padding every install with it. Nothing\nis obfuscated.<\/p>\n\n The plugin loads no JavaScript on the front end at all \u2014 that bundle is the block editor's, and\nnothing else.<\/p>\n\n\n From your dashboard<\/strong><\/p>\n\n From a downloaded .zip<\/strong><\/p>\n\n By FTP<\/strong><\/p>\n\n In any post, page, or template, add the Perennial: Copyright Notice<\/strong> block.<\/p>\n\n On a block theme, add it once to your footer template part in Appearance \u2192 Editor<\/strong> and every\npage that uses that footer carries it. On a classic theme there is no footer template part to add\nit to, so place the block wherever you want the notice.<\/p>\n\n There is no settings screen. Everything the block does is in its own settings and styles in the\neditor sidebar.<\/p>\n\n\n No. The year is worked out each time the page is served.<\/p><\/dd>\n The notice itself is always right \u2014 it is worked out when the page is served. What can go stale\nis a cached copy of the finished page: one cached on 31 December keeps serving last year's\nnotice until that cache is cleared.<\/p>\n\n So the plugin clears it, on four caching plugins by name. The first request of the new year that\nWordPress actually builds notices the year has changed and clears the cache. There is no\nscheduled task and nothing to configure \u2014 a cached page is served without WordPress ever loading\nthis plugin, so the only thing that can trigger the check is the next request that is not served\nfrom cache: an admin opening the dashboard, a logged-in reader, a crawler, or any page the cache\nis not already holding.<\/p>\n\n Cleared for you:<\/strong> WP Rocket, W3 Total Cache, WP Super Cache and LiteSpeed Cache \u2014 those four,\nand no others. Each is asked for a full flush, so on W3 Total Cache and LiteSpeed that clears\ntheir object caches too; once a year, deliberately. Each one ties this plugin to somebody else's\ncode, so the list stays deliberately short; the hook in the next question is what scales.<\/p>\n\n Any other cache:<\/strong> if it expires at least once a year, it corrects itself the next time it\nexpires \u2014 which with a twelve-month lifetime can be most of a year. With very long or indefinite\nlifetimes, clear your page cache once after New Year, or set your caching plugin to purge on a\nschedule.<\/p><\/dd>\n Yes \u2014 two hooks, both reached on that same first request of the new year. Neither fires on a\nbrand-new install, which has no previous year on record to compare against.<\/p>\n\n The The Your site's, as set in Settings \u2192 General \u2192 Timezone<\/strong>. Working it out in the visitor's\nbrowser instead would mean someone in Auckland and someone in Los Angeles could see different\nyears for a few hours around New Year.<\/p><\/dd>\n The notice uses your site title, and keeps using it \u2014 so if you rename the site later, every\nnotice updates. Type a name only if you want it to differ from the site title.<\/p><\/dd>\n Yes. Select the block, open the Styles<\/strong> tab, and use Year typography<\/strong> and Year color<\/strong>.\nThese affect only the year and the \u00a9 symbol. The rest of the notice uses the block's normal\ncolor and typography controls.<\/p>\n\n The year's font size is offered in \n
\u00a9 2001 \u2013 2026<\/code> in English. Set the start year to the current\nyear and it shows that year on its own rather than a range of one. The format is\ntranslatable, so a locale can set its own separator, numerals or placement for the \u00a9 symbol.<\/li>\n\n
External services<\/h3>\n\n
Source code<\/h3>\n\n
src\/<\/code> it was built from and\nthe lockfile, package.json<\/code> and webpack config needed to rebuild it. A clean install and a\nrebuild reproduce the shipped bundle:<\/p>\n\npnpm install --frozen-lockfile && pnpm run build\n<\/code><\/pre>\n\n\n
\n
\n
ghostlabs-dynamic-copyright-notice<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\nThen add the notice<\/h4>\n\n
\n
Do I have to do anything on January 1?<\/h3><\/dt>\n
I use a caching plugin. Will the year still update?<\/h3><\/dt>\n
Can I clear my own cache when the year rolls over?<\/h3><\/dt>\n
ghostlabs_perennial_year_rolled_over<\/code> action is passed the new year and the year\nbefore it. It fires whether or not this plugin clears anything, so it is the place to purge a\ncache, CDN or host layer this plugin does not know about.<\/p>\n\nadd_action( 'ghostlabs_perennial_year_rolled_over', function ( $current, $stored ) {\n \/\/ Clear your own cache here.\n}, 10, 2 );\n<\/code><\/pre>\n\nghostlabs_perennial_purge_on_rollover<\/code> filter defaults to true<\/code>. Return false<\/code>\nand the plugin clears nothing itself. The action above still fires, so you can decline the\nbuilt-in purge and still handle it your own way.<\/p><\/dd>\nWhich year does it use if my visitors are in other countries?<\/h3><\/dt>\n
What if I leave the name blank?<\/h3><\/dt>\n
Can I make the year a different color or size from the rest of the line?<\/h3><\/dt>\n
rem<\/code>, em<\/code>, ch<\/code> and %<\/code> rather than pixels, so it scales\nwith your theme and with a reader's text-size settings. The block's own font size control offers\nwhatever units your theme does.<\/p><\/dd>\n\n<\/dl>\n\n\n1.0.0<\/h4>\n\n
\n
ghostlabs_perennial_year_rolled_over<\/code>, passed the new and previous\nyear, so any other cache, CDN or host layer can clear itself.<\/li>\nghostlabs_perennial_purge_on_rollover<\/code> (default true), to turn the\nplugin's own purging off. The action fires either way.<\/li>\n