Jim’s blue grass site has long been a faithful user of the plugins
All posts by anmari
Czech program
Fitness Class Timetables
Brewery Visit Events in Two languages
Clean events widget
Event Roles and Capabilities
From version 3.3 on wards, amr-events now has three optional additional roles:
- Event Contributor
- Event Editor
- Event Manager
If you wish to keep your event creation separate from your post creation, these may be useful. If you are updating the plugin, you may find that you need to force an update of the various roles (even existing admin may need capabilties manually added). So while one hopes not, just in case: use a role manager like https://wordpress.org/plugins/members/
Custom post types, taxonomies , capabilities, roles
Are you you getting the browser messages when saving a new custom post type draft?
- Firefox: “This page is asking you to confirm that you want to leave – data you have entered may not be saved.”
- Internet Explorer: “Are you sure you want to leave this page”
- Chrome: “The changes you have made will be lost if you navigate away from this page”
- “Leave page or Stay on page” when you click save draft on a new custom post type?
What happens?
You opt to leave and the post was still saved but the custom fields etc do not save. BUT then you CAN edit the post and then add in the custom fields / meta box without any further problem (what the?)
And of course admin’s have no problem!
Why?
This appears to be because we have said that the custom post type supports the default taxonomies and possibly wordpress is trying to do something with javascript (maybe assign a default category to the custom post type) but the user is not allowed to. However it also happens when the custom post type has tags but not categories? But it does not happen if it just has the custom taxonomy (with the assign_terms or assign_terms=>edit_events capability). The behaviour only occurs with default taxonomies.
Key finding:
If you are allowing your custom post type to be assigned categories and tag taxonomies like normal posts, then ANY role that is required to be able to create the custom post type while default taxonomies are supported, must also have ‘edit_posts’ capability. (Unless you have code to change the default taxonomies, but then you will be messing with the standard posts capabilities)
Arguably the wordpress default capability ‘assign_terms’ should not be mapped by default to ‘edit_posts’ as this is what is making life complicated. Possibly a contributor should have ‘assign_terms’ capability directly? Or one might say that it’s the sharing of taxonomies that is causing the complication.
Background
I wanted a role that could create events but NOT also create posts. Similarly with editors.
Custom roles can be setup to manage custom post types (in this case events) and one can isolate these capabilities. However when one adds taxonomies (default and custom) into the mix, things get more interesting.
Default taxonomy capabilities for categories and tags
$default_caps = array( 'manage_terms' => 'manage_categories', 'edit_terms' => 'manage_categories', 'delete_terms' => 'manage_categories', 'assign_terms' => 'edit_posts', );
While one could overwrite these capabilities with say ‘assign_terms’=>’assign_terms’, then one would not be able to assign categories and tags to standard post types without also ensuring that the default roles were assigned the capability ‘assign_terms’. All achievable, it just seems wrong to have to mess with standard wp and risk breaking other plugins.
Registering custom taxonomy means that in this case ‘edit_events’ capability is enough to be able to assign this custom taxonomy to this single custom post type
'capabilities' => array ( 'manage_terms'=> 'manage_categories', 'edit_terms'=> 'manage_categories', 'delete_terms'=> 'manage_categories', 'assign_terms' => 'edit_events' // strictly speaking need one for each new posttype ? )
TIP: while you are testing this all out, a role manager plugin like Justin Tadlock’s members plugin is very helpful. Roles and their capabilities are saved in the database and unless you ‘remove’ the role and add it again, the capabilties will not update as you might want them to.
I was actually trying to create a custom role that can assign categories, tags and custom taxonomies to your custom post type. If you give these roles ‘manage_categories’, they’ll be able to add new categories BUT still not assign a post to existing categories. They have to have ‘edit_posts’ or obe has to override the default wp setup.
How to change icon images (subscribe to calendar, add to google)
The plugin comes with two sets of default icons (16px and 32 px). It also includes extra icons that match those for your use.
Don’t like those icons?
You could do one or more of the following:
Switch images off
You could choose just to have the link text for the actions behind the icons. See the “Listing events’ settings.
Use Css to replace the text with your own images
First switch the default images off and then use css to show your chosen icons instead.
There are various techniques that one can use to replace text with an image. The following was used to demonstrate the above replacement using the plugins html classes.
a.icalsubscribe {
display: block;
height: 50px;
width: 50px;
background-image: url(http://i.stack.imgur.com/XtpTm.png);
background-size: 50px 50px;
text-indent: -9999px;
overflow: hidden;
}
Some of the link classes that you may wish to define image icons for are:
- subscribe
- icalsubscribe
- addtogoogle
- hrefaddtogoogle
- hrefmap
- timezone
- refresh
Add the extra css :
- Either to your custom themes stylesheet (not to one that gets updated automatically, because you will lose your modifications), or
- use something like jetpacks wordpress custom css, or
- use a custom ical events list css
Write own formatting routines
See the pluggable files in each plugin folder. Use the function there as a base for your new function. Add your function to your custom themes function.php or to your own site specific snippets plugin.
some pluggable functions in amr-icalevents-list
- add_cal_to_google
- add_event_to_google
- amr_ical_showmap
- amr_show_refresh_option
- amr_format_tz
some pluggable functions in amr-events
- amr_subscribe_to_event_series
- amr_subscribe_to_event
Groupings of events, expanding and collapsing the groupings
Events can be grouped in many ways. To set up groupings see this post on event grouping and styling.
Expand and Contract Groupings
To expand and contract groupings, tick the ‘load js’ in the listing events settings
and optionally add a shortcode to add text to showall or hideall detail of groupings
[expandall]
[events]
Grouping events
Events can be grouped by date formats or by categories, tags or custom taxonomies.
- Events can be grouped by days, weeks, months and some funkier options that no one will probably ever use, but I liked the challenge! Actually I imagined one could do some seasonal styling perhaps? each grouping has it’s own css classes, and date/time format
- Grouping also allows one to do timetables (grouped by day), weekly schedules, or monthly, quarterly or seasonal event views.
- See how to format the date related groupings here.
- Each grouping comes with css classes so you could for example do seasonal styling of event groups.
- By adding in the javascript in the settings, one could also expand and collapse the groupings.
Settings
Styling Groupings – use the css classes
