happyprime/alerts

A WordPress plugin for displaying alerts of various levels for a given amount of time

alerts's Issues

A post with alert is not honoring expires

This is an issue on SMART Transit and I can duplicate it locally.

The post with an alert that has an expiration won't honor the expiration and holds onto the alert level. This prevents the ability to use the alert level as the mechanism to show/not show an alert through the Query Loop.

Steps to reproduce

1. Create a post
2. Set an alert level (you may need to create an alert level)
3. Set alert expires to "yes"
4. Set a time for the alert to expire
5. Wait for the time to expire.
6. Check to see if the post still has the alert level associated to it.

Add meta to mark an alert level term as default

Add a field to capture alert title

Add built files to version control

Add a post type support filter for the alerts plugin

Add dismiss option to alerts/alert-banner block

Add Classic Editor fallback for alert level meta box

register_taxonomy()'s meta_box_cb argument does not automatically work in Gutenberg, so we'll need to implement the first version of this in JavaScript and then loop back around to account for non-Gutenberg post types.

WordPress/gutenberg#13816

Add meta to set date on which alert level should be set to default

Document how alerts can be used with a WordPress query loop block

Register an alert level taxonomy for the `post` post type

Setup current project scaffolding

Tag and "release" current version of Alerts as 1.0.x

Clean up spacing in the Alerts Level interface

Create `alerts/alert-banner` block

The first use case for this block is as a banner at the top of all views.

Block attributes

• Display n alerts
• Order by:
  • Most recent (default)
  • Alert level
    • Select from available alert levels and drag to reorder

Set alert level to default term on alert expiration

test

Remove the alerts post type from the plugin

Confirm that a post type supports custom-fields before adding Alerts support

Without custom fields support, meta is not available in the block editor and the editor crashes.

Alerts 2.0

These thoughts might be for a new plugin, but I will start here. I want to focus on this plugin being more of a utility as opposed to a fully-baked post type with additional technology.

Current alerts plugin goals

• Populate alerts in a banner on a single page or all pages depending on alert level.
• Apply a start and end time for the alert
• Create an archive for current and previous alerts

Goal I think the alerts plugin should focus on

• Populate alerts in a banner on a single page or all pages depending on alert level.
• The start and end time for an alert

I don't think a post type is necessary.

Why

I have seen a few scenarios where the alert plugin is used for general announcements (Swing the Fly) and for events (PFMC). In both cases redirects were created for the alert to point to the actual post. It would be handy allowing any post type to have the ability to populate something that is deemed important into a banner.

Approach

Settings

Once the plugin has been added to the site, somewhere in settings is a place to make a few decisions:

1. What post types should this functionality apply to (regular posts by default -- doesn't create a new post type)
2. Allow level names to be changed or more added (default: alert, broadcast, home highlight, normal)
3. Have a dropdown next to each term that tells the alert what to do (1. Populate on all posts, 2. Populate only on homepage, 3. Normal)
4. A place to toggle between two options for when there are multiple alerts - 1) Populate a single highest priority alert, or 2) Populate all alerts by priority, then newest.

Single post

• A single post that has Alert functionality is a section in the sidebar for selecting the alert level (via the names in settings) and times for the alert to appear at the current selected level. The alert post remains even when the time has ended. The time only removes the level and sets it back to default.
• The frontend should have a class added to body of the single post indicating the current level.

Banners

The banner should populate only the post head of the current alert. All the text should be wrapped in an a to the single post of the alert.

Note: default to only populating one post that has the highest alert level with newest date if there are multiple alerts at once. If the toggle in settings is set to show all current alerts for the banner, then they will be listed by highest alert, then date posted. No limit.

Other thoughts

• Should the user have the option to close alerts and have that stored in the browser so that they don't see alerts that they have closed? This could be an option in settings.
• The alert level should be a taxonomy, allowing to populate its terms into collection outputs like CAB.

Tasks

MVP

• #4
• #5
• #6
• #7
• #8
• #9
• #10
• #15

Future release

• #16

Filter `body_class` on single post views to include alert level