Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[CMSP-995] Notices for low max age values in Page Cache Options #268

Merged
merged 76 commits into from
May 17, 2024

Conversation

jazzsequence
Copy link
Contributor

@jazzsequence jazzsequence commented May 8, 2024

This PR adds a new interface for admin-related things that specifically hook into the options page created by the MU plugin.

Since the MU plugin is a dependency, it adds checks for the MU plugin, as well as the version in the PANTHEON_MU_PLUGIN_VERSION constant to be sure that it's affecting the right things. If the MU plugin is not found, a
Screenshot 2024-05-08 at 3 34 19 PM
notice is displayed in the admin.

If the MU plugin is found to be an older version than the max age changes added in 1.4.0, a notice is shown to update.
Screenshot 2024-05-08 at 12 55 45 PM
Screenshot 2024-05-08 at 12 54 07 PM

Ultimately, this PR is to add a notice that says that the default max-age is too low if it is lower than 1 week. A notice is not shown if no default_ttl option value exists (was never set, therefore using the default version in the MU plugin) or if the value is exactly 600 (work to be done to automatically update that to 1 week in CMSP-994.
Screenshot 2024-05-08 at 12 42 18 PM

This PR also includes Site Health checks for Cache Max Age.
Screenshot 2024-05-08 at 3 26 28 PM

Screenshot 2024-05-08 at 3 30 53 PM

Additional changes in this PR

  • bumps the version to 2.0.0-dev (which wasn't done after 1.5.0) and adds @since tags
  • adds a new script that bails the CircleCI-based Behat workflow out if we don't actually need to run Behat tests (nothing relevant worth testing was changed)
  • updates changelog
  • adds behat & phpunit tests

Todo

  • write tests

Copy link
Contributor

github-actions bot commented May 8, 2024

Composer Changes

Dev Packages Operation Base Target
nikic/php-parser Upgraded v5.0.1 v5.0.2
pantheon-systems/pantheon-wordpress-upstream-tests Changed dev-master 004fc97 dev-master 612d7d3
phar-io/manifest Upgraded 2.0.3 2.0.4
phpcompatibility/phpcompatibility-paragonie Upgraded 1.3.2 1.3.3
phpcompatibility/phpcompatibility-wp Upgraded 2.1.4 2.1.5
phpcsstandards/phpcsutils Upgraded 1.0.9 1.0.11
phpstan/phpdoc-parser Upgraded 1.26.0 1.29.0
phpunit/php-code-coverage Upgraded 9.2.30 9.2.31
phpunit/phpunit Upgraded 9.6.17 9.6.19
sebastian/cli-parser Upgraded 1.0.1 1.0.2
sebastian/diff Upgraded 4.0.5 4.0.6
sebastian/exporter Upgraded 4.0.5 4.0.6
sebastian/global-state Upgraded 5.0.6 5.0.7
sebastian/resource-operations Upgraded 3.0.3 3.0.4
sirbrillig/phpcs-variable-analysis Upgraded v2.11.17 v2.11.18
slevomat/coding-standard Upgraded 8.14.1 8.15.0
spryker/code-sniffer Upgraded 0.17.21 0.17.23
squizlabs/php_codesniffer Upgraded 3.9.0 3.9.2
symfony/console Upgraded v5.4.35 v5.4.39
symfony/css-selector Upgraded v5.4.35 v5.4.39
symfony/deprecation-contracts Upgraded v3.4.0 v3.5.0
symfony/event-dispatcher Upgraded v5.4.35 v5.4.39
symfony/event-dispatcher-contracts Upgraded v3.4.0 v3.5.0
symfony/filesystem Upgraded v5.4.35 v5.4.39
symfony/process New - v6.4.7
symfony/service-contracts Upgraded v2.5.2 v2.5.3
symfony/string Upgraded v6.4.3 v6.4.7
symfony/translation-contracts Upgraded v2.5.2 v2.5.3
symfony/yaml Upgraded v6.4.3 v6.4.7
theseer/tokenizer Upgraded 1.2.2 1.2.3
wp-coding-standards/wpcs Upgraded 3.0.1 3.1.0
yoast/phpunit-polyfills Upgraded 2.0.0 2.0.1

this shows us that our ranking function is working
because goutte doesn't natively interpret html comments
@jazzsequence jazzsequence marked this pull request as ready for review May 14, 2024 18:38
@jazzsequence jazzsequence requested a review from a team as a code owner May 14, 2024 18:38
@jazzsequence jazzsequence requested a review from pwtyler May 14, 2024 18:38
since phpunit is no longer run on circle
@pwtyler
Copy link
Member

pwtyler commented May 14, 2024

If we're going to add @since 2.0.0 then it would be weird to not version bump in this PR to 2.0.0, but I agree with the suggestion, we should probably add that to the new stuff.

Adding the current -dev target that is in readme.md should get search-replace'd by release-pr action https://github.com/pantheon-systems/plugin-release-actions/blob/main/release-pr/release-pr.sh (although that should not be 100% trusted)... back in testing I at least intended that @since blocks would be handled.

Copy link
Member

@pwtyler pwtyler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one question noted in-line.

I think it would be appropriate to note in the changelog or upgrade notice the changes in default behavior that were applied elsewhere (mu plugin) either linking to the mu or pantheon changelog.

inc/admin-interface.php Show resolved Hide resolved
bin/maybe-skip-tests.sh Outdated Show resolved Hide resolved
Copy link
Member

@pwtyler pwtyler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comments on the tests but none will affect coverage so will leave at your discretion.

tests/phpunit/test-admin-interface.php Outdated Show resolved Hide resolved
tests/phpunit/test-admin-interface.php Outdated Show resolved Hide resolved
tests/phpunit/test-admin-interface.php Outdated Show resolved Hide resolved
@jazzsequence jazzsequence merged commit 83df364 into develop May 17, 2024
10 checks passed
@jazzsequence jazzsequence deleted the cmsp-994-995 branch May 17, 2024 15:20
jazzsequence added a commit that referenced this pull request May 28, 2024
* [CMSP-995] Notices for low max age values in Page Cache Options (#268)

* add initial admin interface class
hook to mu-plugin > 1.4.0

* some more scaffolding

* require at least 6.4

* don't show notices if wp_admin_notice doesn't exist

* add notice if mu-plugin was not found

* add notice if the mu-plugin is old

* fix link and change decimal to string

* use spaces instead of line breaks

* add helper function to get current max age
this is either set in the mu-plugin or empty. if empty, it should default to 1 week

* add notice if less than 1 week but not == 600 seconds

* add docblock

* add translator comments

* update tested up to and requires at least values in readmes

* version bump

* bump composer deps

* don't display the warnings if we aren't on the pantheon cache admin page

* convert static class to a namespace
there's no reason to make this a class since we're not using any class features

* add a bootstrapper for namespace-only files

* lint

* escape the wp_die message

* use a helper for humanized time calculations

* we still need to test the current max age

* pass the current max age to the message, too
and be specific that we're talking about seconds

* use the filterable value for default max age
because it could be something different

* add a helper function for retrieving the default max age
this is helpful so we can always return the filtered value

* also display the seconds in the successful test

* rank the max age value
don't say it's "very low" unless that's actually accurate.

* add caching to the ranked compare

* make the color more severe if it's a bigger issue

* change the color of the admin notice based on the severity of the diff

* clear the transient when the option is updated

* break notice type into a variable

* fix the translator note

* keep the rank but hide it from the dom

* add unit tests

* add initial behat test
let's just see if we can assume this will work

* fix failing test

* specify the element where the notices are

* add site health check test

* actually save the changes

* remove max age check
only exists in an html comment anyway

* simplify the site health check

* add the message when you expand the accordion

* add other site health things

* change press to click?

* add "open the accordion" as a custom step

* move behat stuff around

* move stuff around again

* update the behat.yml

* remove custom context and try "when I follow"

* move to checking the text inside the elements

* target the hidden element

* use hidden='hidden'

* call it a div

* simplify the tests

* remove press
since we can't actually press

* it did actually find the right heading
maybe it will find the right text?

* add @\since tags

* add changelog and upgrade notice

* let's try checking for some of the hidden text

* period at the end of the sentence

* add the ranks back
this shows us that our ranking function is working

* add the messages

* remove age rank tests
because goutte doesn't natively interpret html comments

* add github testing badge
since phpunit is no longer run on circle

* add script to maybe skip behat tests if we don't need to run them

* add step to workflow

* do not run if the circle config changes

* also ignore if scripts (that aren't behat-related) have changed

* fix the logic (again)

* one more flippity flip

* remove the "ignoring" message
it's actually implied by the fact that is_ignored is checked

* use function to determine if a file should be ignored

Co-authored-by: Phil Tyler <[email protected]>

* update changelog to note mu-plugin updates

* Update tests/phpunit/test-admin-interface.php

* use data providers to simplify the tests

---------

Co-authored-by: Phil Tyler <[email protected]>

* [CMSP-994] Automatically update the `default_ttl` value if it was set to 600 (#269)

* add initial admin interface class
hook to mu-plugin > 1.4.0

* some more scaffolding

* require at least 6.4

* don't show notices if wp_admin_notice doesn't exist

* add notice if mu-plugin was not found

* add notice if the mu-plugin is old

* fix link and change decimal to string

* use spaces instead of line breaks

* add helper function to get current max age
this is either set in the mu-plugin or empty. if empty, it should default to 1 week

* add notice if less than 1 week but not == 600 seconds

* add docblock

* add translator comments

* update tested up to and requires at least values in readmes

* version bump

* bump composer deps

* don't display the warnings if we aren't on the pantheon cache admin page

* convert static class to a namespace
there's no reason to make this a class since we're not using any class features

* add a bootstrapper for namespace-only files

* lint

* escape the wp_die message

* use a helper for humanized time calculations

* we still need to test the current max age

* pass the current max age to the message, too
and be specific that we're talking about seconds

* use the filterable value for default max age
because it could be something different

* add a helper function for retrieving the default max age
this is helpful so we can always return the filtered value

* also display the seconds in the successful test

* rank the max age value
don't say it's "very low" unless that's actually accurate.

* add caching to the ranked compare

* make the color more severe if it's a bigger issue

* change the color of the admin notice based on the severity of the diff

* clear the transient when the option is updated

* break notice type into a variable

* fix the translator note

* keep the rank but hide it from the dom

* add unit tests

* add initial behat test
let's just see if we can assume this will work

* fix failing test

* specify the element where the notices are

* add site health check test

* actually save the changes

* remove max age check
only exists in an html comment anyway

* simplify the site health check

* add the message when you expand the accordion

* add other site health things

* change press to click?

* add "open the accordion" as a custom step

* move behat stuff around

* move stuff around again

* update the behat.yml

* remove custom context and try "when I follow"

* move to checking the text inside the elements

* target the hidden element

* use hidden='hidden'

* call it a div

* simplify the tests

* remove press
since we can't actually press

* it did actually find the right heading
maybe it will find the right text?

* add @\since tags

* add changelog and upgrade notice

* let's try checking for some of the hidden text

* period at the end of the sentence

* add the ranks back
this shows us that our ranking function is working

* add the messages

* remove age rank tests
because goutte doesn't natively interpret html comments

* add github testing badge
since phpunit is no longer run on circle

* add script to maybe skip behat tests if we don't need to run them

* add step to workflow

* do not run if the circle config changes

* also ignore if scripts (that aren't behat-related) have changed

* fix the logic (again)

* one more flippity flip

* remove the "ignoring" message
it's actually implied by the fact that is_ignored is checked

* use function to determine if a file should be ignored

Co-authored-by: Phil Tyler <[email protected]>

* update changelog to note mu-plugin updates

* add functionality to automatically set the default_ttl if it was set to 600

* trigger the setting change and display an admin notice informing users it was done
only show the notice to users who haven't already seen it and who can manage_options

* add unit tests for set_max_age_to_default

* move the max age update notice to the bootstrap

* remove the set_max_age_updated helper
this wasn't working and meant that we were needing to make multiple update options in a short space of time. we might have actually been running into race conditions where one update was overwriting the other one.

* use a new option for the updated flag

* add _notice to the user meta key so it's distinct from the new option

* update tests for new changes

* add translator note

* user notice about 600 second update is not dismissable
because it only appears once

* don't show seconds in updated notice

* pass the function into the apply_filter hook
so you can selectively disable specific notices

* add docblock

* add test for the notice

* return the value of disable_notices
rather than hard-coded "false"

* Add scenario to set max-age to 600 and auto-update to the default value

* here's a behat test that might not work
not sure if it will know what pantheon-cache[default-ttl] is without giving it an element to look at.

* fixed it based on upstream tests

* refresh the page

* go to instead of refresh
since refresh isn't a thing ¯\_(ツ)_/¯

* add additional test failure messaging

* break up tests

---------

Co-authored-by: Phil Tyler <[email protected]>

* [CMSP-995] one more notice (#271)

* add a global admin notice that appears once

* remove seconds from the notice

* test the new notice

* set dismissable depending on which notice we're showing

* show the max age rank html comment

* fix the conditionals for cs

* update behat tests for new notice language

* bugfix: don't update user meta that max_age was updated if it hasn't been

* add one more thing to test in behat

* add a test for the error, specifically

* add a test for the warning

* simplify the conditionals

* lint

* specify the pages that we're on?

* remove specific element

* fix typo

* take out the dashboard main page goto

* validate the setting was saved

* let's just remove the 5 days notice

* just remove the test
we have similar things being tested in phpunit

* we can actually remove current_max_age >= WEEK_IN_SECONDS
this is covered by max_age_rank. if max_age_rank is 0 it, by definition, means that the current max age is >= WEEK_IN_SECONDS

* if we're only comparing two things, we don't need to break the if clauses up

* we do want to warn users if they have manually set their max age to 600
we just don't want to warn them if we're about to (or just did) change it to a week for them

* [CMSP-992] UI changes (#272)

* add initial admin interface class
hook to mu-plugin > 1.4.0

* some more scaffolding

* require at least 6.4

* don't show notices if wp_admin_notice doesn't exist

* add notice if mu-plugin was not found

* add notice if the mu-plugin is old

* fix link and change decimal to string

* use spaces instead of line breaks

* add helper function to get current max age
this is either set in the mu-plugin or empty. if empty, it should default to 1 week

* add notice if less than 1 week but not == 600 seconds

* add docblock

* add translator comments

* update tested up to and requires at least values in readmes

* version bump

* bump composer deps

* don't display the warnings if we aren't on the pantheon cache admin page

* convert static class to a namespace
there's no reason to make this a class since we're not using any class features

* add a bootstrapper for namespace-only files

* lint

* escape the wp_die message

* use a helper for humanized time calculations

* we still need to test the current max age

* pass the current max age to the message, too
and be specific that we're talking about seconds

* use the filterable value for default max age
because it could be something different

* add a helper function for retrieving the default max age
this is helpful so we can always return the filtered value

* also display the seconds in the successful test

* rank the max age value
don't say it's "very low" unless that's actually accurate.

* add caching to the ranked compare

* make the color more severe if it's a bigger issue

* change the color of the admin notice based on the severity of the diff

* clear the transient when the option is updated

* break notice type into a variable

* fix the translator note

* keep the rank but hide it from the dom

* add unit tests

* add initial behat test
let's just see if we can assume this will work

* fix failing test

* specify the element where the notices are

* add site health check test

* actually save the changes

* remove max age check
only exists in an html comment anyway

* simplify the site health check

* add the message when you expand the accordion

* add other site health things

* change press to click?

* add "open the accordion" as a custom step

* move behat stuff around

* move stuff around again

* update the behat.yml

* remove custom context and try "when I follow"

* move to checking the text inside the elements

* target the hidden element

* use hidden='hidden'

* call it a div

* simplify the tests

* remove press
since we can't actually press

* it did actually find the right heading
maybe it will find the right text?

* add @\since tags

* add changelog and upgrade notice

* let's try checking for some of the hidden text

* period at the end of the sentence

* add the ranks back
this shows us that our ranking function is working

* add the messages

* remove age rank tests
because goutte doesn't natively interpret html comments

* add github testing badge
since phpunit is no longer run on circle

* add script to maybe skip behat tests if we don't need to run them

* add step to workflow

* do not run if the circle config changes

* also ignore if scripts (that aren't behat-related) have changed

* fix the logic (again)

* one more flippity flip

* remove the "ignoring" message
it's actually implied by the fact that is_ignored is checked

* use function to determine if a file should be ignored

Co-authored-by: Phil Tyler <[email protected]>

* update changelog to note mu-plugin updates

* add functionality to automatically set the default_ttl if it was set to 600

* trigger the setting change and display an admin notice informing users it was done
only show the notice to users who haven't already seen it and who can manage_options

* add unit tests for set_max_age_to_default

* move the max age update notice to the bootstrap

* remove the set_max_age_updated helper
this wasn't working and meant that we were needing to make multiple update options in a short space of time. we might have actually been running into race conditions where one update was overwriting the other one.

* use a new option for the updated flag

* add _notice to the user meta key so it's distinct from the new option

* update tests for new changes

* add translator note

* user notice about 600 second update is not dismissable
because it only appears once

* don't show seconds in updated notice

* pass the function into the apply_filter hook
so you can selectively disable specific notices

* add docblock

* add test for the notice

* return the value of disable_notices
rather than hard-coded "false"

* Add scenario to set max-age to 600 and auto-update to the default value

* here's a behat test that might not work
not sure if it will know what pantheon-cache[default-ttl] is without giving it an element to look at.

* fixed it based on upstream tests

* refresh the page

* go to instead of refresh
since refresh isn't a thing ¯\_(ツ)_/¯

* remove all the old npm stuff and use all new npm stuff

* add node build to the build & tag workflow

* add del package

* repurpos gruntfile into gulpfile

* repackage gulpfile and package.json as a module

* add additional test failure messaging

* gitignore assets

* don't export the gulpfile

* invoke sass correctly

* proper sassing

* add a main.scss file

* compiler tweaks

* use concat

* initial styles

* enqueue css

* use the filter added in pantheon-systems/pantheon-mu-plugin#46 to add header

* some initial styles for the max age box

* add a global admin notice that appears once

* remove seconds from the notice

* test the new notice

* set dismissable depending on which notice we're showing

* show the max age rank html comment

* fix the conditionals for cs

* update behat tests for new notice language

* bugfix: don't update user meta that max_age was updated if it hasn't been

* add one more thing to test in behat

* add a test for the error, specifically

* add a test for the warning

* simplify the conditionals

* lint

* specify the pages that we're on?

* remove specific element

* fix typo

* take out the dashboard main page goto

* validate the setting was saved

* let's just remove the 5 days notice

* just remove the test
we have similar things being tested in phpunit

* we can actually remove current_max_age >= WEEK_IN_SECONDS
this is covered by max_age_rank. if max_age_rank is 0 it, by definition, means that the current max age is >= WEEK_IN_SECONDS

* if we're only comparing two things, we don't need to break the if clauses up

* we do want to warn users if they have manually set their max age to 600
we just don't want to warn them if we're about to (or just did) change it to a week for them

* there should only be one css file

* remove seconds

* check stored default_ttl value

* fix failing test

* fix translators note

* remove seconds

* remove redundant check

* tweak the logic again

* fix the test by updating the default ttl

* add the description after the input

* styles for box and info bar

* update the filter name

* filter the input box

* add a padding helper

* ...and use it

* lint

* add styling for links in the info bar.

* no padding on the right
padding the right makes the bar flush with the edge of the box

* adjust h3 margin
so it looks better when there's no banner

* style the select input

* don't render the info bar

* use wp_kses_post instead of esc_html_e
we might want to add links to this bar

* helper function for available dropdown options and make it filterable

* Refactor default_ttl_input function to handle custom options and filterable dropdown

* remove seconds from behat tests

* add a period for dumb lint rule

* remove hyphen from max-age
in everything user-facing

* update the tests

* conditionally append a timestamp to the css version
to refresh it on each page load if debug is true

* don't show the input box if the ttl is unset

* remove filters in teardown

* remove hyphen in tests

* specify method visibility

* test the setting description callback

* test the default ttl option input callback

* test max_age_options and filter

* add a behat test for the select input

* maybe change the then

* remove all hyphens

* be more specific about the select input

* try using the class and the select

* let's try checking to see if the response contains the selected option

* print for debugging

* one last try before I give up

* remove the new behat test

* use a simple true/false gate for max_age header

* display a warning if the default_ttl is saved to a value that's not one of the default optiosn

* show the dropdown with the custom value
so a new value can be selected from the droptdown when prompted

* remove placeholder comment

* gix the global warning shown logic

* make sure to take into consideration custom and filtered

* bail early if the max age is filtered

* better comment

* remove value range entirely

* remove recommendation if filtered

* break out custom and filtered outputs
filtered displays the grayed out input box
custom adds to the dropdown

* update tests

* translator note

* move the debug note

Co-authored-by: Phil Tyler <[email protected]>

* add since and return values

* push the description down a bit

* personalized message based on current cache max age

* remove current when not necessary

* update tests, add a data provider

* use boolean variable names
`$is_filtered` instead of `$filtered`
`$has_custom_ttl` instead of `$custom` and `$custom_ttl`

---------

Co-authored-by: Phil Tyler <[email protected]>

* [CMSP-992] plugin documentation update (#273)

* add initial admin interface class
hook to mu-plugin > 1.4.0

* some more scaffolding

* require at least 6.4

* don't show notices if wp_admin_notice doesn't exist

* add notice if mu-plugin was not found

* add notice if the mu-plugin is old

* fix link and change decimal to string

* use spaces instead of line breaks

* add helper function to get current max age
this is either set in the mu-plugin or empty. if empty, it should default to 1 week

* add notice if less than 1 week but not == 600 seconds

* add docblock

* add translator comments

* update tested up to and requires at least values in readmes

* version bump

* bump composer deps

* don't display the warnings if we aren't on the pantheon cache admin page

* convert static class to a namespace
there's no reason to make this a class since we're not using any class features

* add a bootstrapper for namespace-only files

* lint

* escape the wp_die message

* use a helper for humanized time calculations

* we still need to test the current max age

* pass the current max age to the message, too
and be specific that we're talking about seconds

* use the filterable value for default max age
because it could be something different

* add a helper function for retrieving the default max age
this is helpful so we can always return the filtered value

* also display the seconds in the successful test

* rank the max age value
don't say it's "very low" unless that's actually accurate.

* add caching to the ranked compare

* make the color more severe if it's a bigger issue

* change the color of the admin notice based on the severity of the diff

* clear the transient when the option is updated

* break notice type into a variable

* fix the translator note

* keep the rank but hide it from the dom

* add unit tests

* add initial behat test
let's just see if we can assume this will work

* fix failing test

* specify the element where the notices are

* add site health check test

* actually save the changes

* remove max age check
only exists in an html comment anyway

* simplify the site health check

* add the message when you expand the accordion

* add other site health things

* change press to click?

* add "open the accordion" as a custom step

* move behat stuff around

* move stuff around again

* update the behat.yml

* remove custom context and try "when I follow"

* move to checking the text inside the elements

* target the hidden element

* use hidden='hidden'

* call it a div

* simplify the tests

* remove press
since we can't actually press

* it did actually find the right heading
maybe it will find the right text?

* add @\since tags

* add changelog and upgrade notice

* let's try checking for some of the hidden text

* period at the end of the sentence

* add the ranks back
this shows us that our ranking function is working

* add the messages

* remove age rank tests
because goutte doesn't natively interpret html comments

* add github testing badge
since phpunit is no longer run on circle

* add script to maybe skip behat tests if we don't need to run them

* add step to workflow

* do not run if the circle config changes

* also ignore if scripts (that aren't behat-related) have changed

* fix the logic (again)

* one more flippity flip

* remove the "ignoring" message
it's actually implied by the fact that is_ignored is checked

* use function to determine if a file should be ignored

Co-authored-by: Phil Tyler <[email protected]>

* update changelog to note mu-plugin updates

* add functionality to automatically set the default_ttl if it was set to 600

* trigger the setting change and display an admin notice informing users it was done
only show the notice to users who haven't already seen it and who can manage_options

* add unit tests for set_max_age_to_default

* move the max age update notice to the bootstrap

* remove the set_max_age_updated helper
this wasn't working and meant that we were needing to make multiple update options in a short space of time. we might have actually been running into race conditions where one update was overwriting the other one.

* use a new option for the updated flag

* add _notice to the user meta key so it's distinct from the new option

* update tests for new changes

* add translator note

* user notice about 600 second update is not dismissable
because it only appears once

* don't show seconds in updated notice

* pass the function into the apply_filter hook
so you can selectively disable specific notices

* add docblock

* add test for the notice

* return the value of disable_notices
rather than hard-coded "false"

* Add scenario to set max-age to 600 and auto-update to the default value

* here's a behat test that might not work
not sure if it will know what pantheon-cache[default-ttl] is without giving it an element to look at.

* fixed it based on upstream tests

* refresh the page

* go to instead of refresh
since refresh isn't a thing ¯\_(ツ)_/¯

* remove all the old npm stuff and use all new npm stuff

* add node build to the build & tag workflow

* add del package

* repurpos gruntfile into gulpfile

* repackage gulpfile and package.json as a module

* add additional test failure messaging

* gitignore assets

* don't export the gulpfile

* invoke sass correctly

* proper sassing

* add a main.scss file

* compiler tweaks

* use concat

* initial styles

* enqueue css

* use the filter added in pantheon-systems/pantheon-mu-plugin#46 to add header

* some initial styles for the max age box

* add a global admin notice that appears once

* remove seconds from the notice

* test the new notice

* set dismissable depending on which notice we're showing

* show the max age rank html comment

* fix the conditionals for cs

* update behat tests for new notice language

* bugfix: don't update user meta that max_age was updated if it hasn't been

* add one more thing to test in behat

* add a test for the error, specifically

* add a test for the warning

* simplify the conditionals

* lint

* specify the pages that we're on?

* remove specific element

* fix typo

* take out the dashboard main page goto

* validate the setting was saved

* let's just remove the 5 days notice

* just remove the test
we have similar things being tested in phpunit

* we can actually remove current_max_age >= WEEK_IN_SECONDS
this is covered by max_age_rank. if max_age_rank is 0 it, by definition, means that the current max age is >= WEEK_IN_SECONDS

* if we're only comparing two things, we don't need to break the if clauses up

* we do want to warn users if they have manually set their max age to 600
we just don't want to warn them if we're about to (or just did) change it to a week for them

* there should only be one css file

* remove seconds

* check stored default_ttl value

* fix failing test

* fix translators note

* remove seconds

* remove redundant check

* tweak the logic again

* fix the test by updating the default ttl

* add the description after the input

* styles for box and info bar

* update the filter name

* filter the input box

* add a padding helper

* ...and use it

* lint

* add styling for links in the info bar.

* no padding on the right
padding the right makes the bar flush with the edge of the box

* adjust h3 margin
so it looks better when there's no banner

* style the select input

* don't render the info bar

* use wp_kses_post instead of esc_html_e
we might want to add links to this bar

* helper function for available dropdown options and make it filterable

* Refactor default_ttl_input function to handle custom options and filterable dropdown

* remove seconds from behat tests

* add a period for dumb lint rule

* remove hyphen from max-age
in everything user-facing

* update the tests

* conditionally append a timestamp to the css version
to refresh it on each page load if debug is true

* don't show the input box if the ttl is unset

* remove filters in teardown

* remove hyphen in tests

* specify method visibility

* test the setting description callback

* test the default ttl option input callback

* test max_age_options and filter

* add a behat test for the select input

* maybe change the then

* remove all hyphens

* be more specific about the select input

* try using the class and the select

* let's try checking to see if the response contains the selected option

* print for debugging

* one last try before I give up

* remove the new behat test

* use a simple true/false gate for max_age header

* display a warning if the default_ttl is saved to a value that's not one of the default optiosn

* show the dropdown with the custom value
so a new value can be selected from the droptdown when prompted

* remove placeholder comment

* gix the global warning shown logic

* make sure to take into consideration custom and filtered

* bail early if the max age is filtered

* better comment

* remove value range entirely

* remove recommendation if filtered

* break out custom and filtered outputs
filtered displays the grayed out input box
custom adds to the dropdown

* update tests

* translator note

* move the debug note

Co-authored-by: Phil Tyler <[email protected]>

* add since and return values

* push the description down a bit

* personalized message based on current cache max age

* remove current when not necessary

* update tests, add a data provider

* update changelog

* cache max age filter docs

* document filter to disable notices

* emdash

Co-authored-by: Phil Tyler <[email protected]>

* add missing links

* emdash

* update the 2.0.0 upgrade notice

* add upgrade notice to .md

* remove linebreak

* add -dev tag to versions

* fix readme spacing

---------

Co-authored-by: Phil Tyler <[email protected]>

* Add NPM Diff action (#275)

* use NPM Lockfile Changes

* make sure the workflow also runs when package-lock files are updated

* rename the workflow file
since it's not just composer anymore

* allow fuzzy matching
because excluded subdirectory files should not trigger behat tests

* Build unminified css (#276)

* add gulp-rename
for renaming the minified css file

* update the build workflow to create two css files

* explicitly enqueue the minified css file

* define the path

* full path to workspace?

* add an npm install step
to generate the lockfile
might be ignored by .gitattributes

* re-add path

* don't fail if the test fails

* temporarily don't ignore package-lock.json files

* remove path

* run workflow when the workflow itself is changed
so we can see the effects of our changes

* pass path

* remove unnecessary params
the defaults cover these

* comment out the npm package diff and add description why

* don't run on package-lock updates

* don't run the workflow if the release event is a pre-release (#277)

* update validator version to v1 (#278)

since autotag is now running

* remove gitignore rule to ignore compiled css files (#280)

* fix syntax error in conditional (#281)

* fix syntax error in conditional

* add a workflow that validates workflows

* [CMSP-1193] Filter `pantheon_cache_default_max_age`  when nonces are created (#282)

* require the wp_screen class if it's not loaded

* filter default cache max age to less than nonce_life when creating nonces

* add tests

* update changelog

* add props

* re-add package-lock.json to .gitattributes (#284)

* Release 2.0.0

---------

Co-authored-by: Chris Reynolds <[email protected]>
Co-authored-by: Phil Tyler <[email protected]>
Co-authored-by: Pantheon Automation <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants