bobbingwide/tags

TAGS - The Anchor Golf Society's WordPress plugin

tags

• Contributors: bobbingwide
• Donate link: https://www.oik-plugins.com/oik/oik-donate/
• Tags: CPTs, golf, events, players, results
• Requires at least: 5.0.0
• Tested up to: 6.4.3
• Stable tag: 0.6.2
• License: GPL v3
• License URI: http://www.gnu.org/licenses/gpl-3.0.html

Description

TAGS - The Anchor Golf Society's WordPress plugin.

Used in conjunction with the Genesis child theme genesis-tags this provides the functionality to display the events for The Anchor Golf Society.

It is dependent upon:, oik, oik-fields, oik-bob-bing-wide, oik-css, oik-dates, oik-types, oik-user and the theme relies on oik-rwd for some responsive behaviour.

Installation

1. Upload the contents of the tags plugin to the `/wp-content/plugins/tags' directory
2. Activate the tags plugin through the 'Plugins' menu in WordPress

Frequently Asked Questions

Screenshots

None

Upgrade Notice

0.6.2

Update for support for PHP 8.3

0.6.1

Update for support for PHP 8.1 and PHP 8.2

0.6.0

Update for support for PHP 8.1 and PHP 8.2

0.5.0

Update for Player membership (_player_mem ) virtual field.

0.4.3

Contains a fix for PHP 7.4 compatibility.

0.4.2

Upgrade for total player summary and tee time draw recommendation.

0.4.1

Upgrade for an improved solution for the Events list on the Courses tab.

0.4.0

Upgrade for NTP on 27 holes, Results entry improvement and display of Events by Course.

0.3.1

Upgrade to support competitors requiring Buggies.

0.3.0

Upgrade for enhanced Player display using [tags_achievements] and yearly results [tags_results] shortcode.

0.2.0

Upgrade for enhanced Player display - with Results and Attendance

0.1.0

Upgrade for peaceful coexistence with WordPress 5.0 and/or Gutenberg

0.0.2

Improvements for display of tabs for Events

0.0.1

17 - 21 Apr 2016 - improvements for SEO, display all events and bunging onto GitHub as GPL-3.0

0.0.0

New bespoke plugin. Originally developed to migrate content from Drupal to WordPress.

Changelog

0.6.2

• Changed: Support PHP 8.1, PHP 8.2 and PHP 8.3 #21
• Fixed: Unexpected links when updating Results #20
• Tested: With WordPress 6.4.3
• Tested: With PHP 8.3
• Tested: With PHPUnit 9.6

0.6.1

• Fixed: Unexpected links when updating Results #20
• Changed: Support PHP 8.1 and PHP 8.2 #19
• Tested: With WordPress 6.4.1
• Tested: With PHP 8.0, PHP 8.1 and PHP 8.2
• Tested: With PHPUnit 9.6

0.6.0

• Changed: Support PHP 8.1 and PHP 8.2 #19
• Tested: With WordPress 6.4-RC3
• Tested: With PHP 8.0, PHP 8.1 and PHP 8.2
• Tested: With PHPUnit 9.6

0.5.0

• Changed: Display information regarding a player's membership status on the Player list for future events. #18
• Tested: With WordPress 6.2.2

0.4.3

• Fixed: PHP 7.4 compatibility #16

0.4.2

• Fixed: Change _cost field to text to allow for TBC or FREE #17
• Added: Add player grid logic below the grouping #16
• Tested: With WordPress 6.2-RC2
• Tested: With PHP 8.0

0.4.1

• Fixed: Added exclude=-1 parameter for Events list on Courses tab #14

0.4.0

• Changed: Automatically display Events for Courses #14
• Changed: Allow for 27 holes #15
• Fixed: Set event_date on/before the current time so it doesn't become scheduled #13
• Tested: With WordPress 6.0.1
• Tested: With PHP 8.0

0.3.1

• Changed: Added Buggy option for competitors #11
• Fixed: Avoid Warning for null result_type on the 8 new rows #12
• Fixed: Cater for most recent update in bw_get_posts() by using exclude => -1 #12
• Tested: With WordPress 5.8.2
• Tested: With PHP 8.0

0.3.0

• Changed: Implement [tags_achievements] shortcode to replace the results [bw_related] shortcode #8
• Changed: Change orderby=result_type to orderby=ID #10
• Added: Implement [tags_results] shortcode #9
• Tested: With WordPress 5.8.2
• Tested: With PHP 8.0

0.2.0

• Added: Results and Attendance section automatically added for a Player, #8

0.1.0

• Fixed: Determine lat and long automatically from address and post code,#5
• Changed: Support for WordPress 5.0 and the new block editor, #6
• Changed: Improve the initial selection of the Select the event selection list,#7
• Tested: With WordPress 5.0.3
• Tested: With Gutenberg 4.9.0
• Tested: With PHP 7.2

0.0.2

• Changed: Improve display of Events #1

0.0.1

• Added: GPL v3
• Changed: Improved SEO for Course post type
• Changed: Change label for playing_status from Statuses to Playing?

0.0.0

• Added: New plugin, November 2015, just before the AGM 2015

Further reading

If you want to read more about the oik plugins then please visit the oik plugin "the oik plugin - for often included key-information"

tags's Issues

Support for WordPress 5.0 and the new block editor

Change the registration of the following Custom Post Types to support editing using the new block editor.

• course
• trophy
• player
• event
• competitor
• result

For each post type registration add

$post_type_args['show_in_rest'] = true;

and ensure that the post type supports 'revisions' in addition to other supports values. e.g.

$post_type_args['supports'] = array( 'title', 'editor', 'author', 'revisions' );

Unexpected links output when updating Results

After updating the results for an event there are links being displayed for the new items of type None.

Note: The problem doesn't occur in my local environment.

[bw_related] shortcode not expanded on the Course tab

When viewing the latest event yesterday I noticed that the Course tab displayed the details for the course but the [bw_related] shortcode from that post's content was not expanded.

https://www.anchorgolf.com/event/25-jun-2022-the-hampshire/?oik-tab=course

Explanation

• The shortcode is part of a Reusable block called Event history.

• The shortcode is expanded when we view the Course directly.
• But it's not expanded when the reusable block is embedded in content from [bw_pages]

The problem also occurs in the development environment.

Don't display cost as 0.00 when price is TBC or FREE

When we don't know the price of an event I enter TBC or FREE
But this is converted to 0.00 on the front end.
If the cost is non-numeric it should be displayed as is.

Events: Display player name and membership on the Players tab

When it comes to knowing what to charge a player for a competition we need to know the player's status.

• For monthly Saturday competitions Members must pay their subs and any backsubs.
• Most other memberships type should be treated as a guest of some form.
• Guests with bona-fide handicaps* are entitled to enter the competion on payment of an entry fee.
• Other guests are not entitled to win the competition, but can win NTPs.

(*) Bona-fide handicaps are:

• WHS handicap.
• TAGS handicap, based on at least 3 individual stableford rounds played with the society
• Handicap confirmed by another society

Requirement

• Introduce a membership status of Competitive Guest.
• Display information regarding a player's membership status on the Player list for future events.

The definition of a Competitive Guest is

A guest player at The Anchor Golf Society's events who is allowed to enter competitions on payment of a competition fee. Competitive Guests are those who have a bona-fide handicap, as defined above.

Note: All players should play off the lower of their TAGS or WHS handicap.

Display a player's membership status

Value	Means	Can enter comp?	Subs required?
Player Name	Member	Yes	Yes
Player Name (G)	Ex-member / Competitive Guest	Yes	No
Player Name (g)	Guest / One-off Guest	No	No
Player Name (G)(g)	Both Ex-member and a guest	Yes	No
Player Name (S)	Sabbatical	Yes	No

Notes:

• The capital (G) indicates that the guest is entitled to pay the competition entry fee.
• Lower case (g) means the guest is NOT entitled to pay the competition entry fee.
• The last two displays should not happen.
• For (G)(g) the player should either an Ex-member or a Guest.
• For (S) the player should decide on whether or not to return as a member, or become an Ex-member.
• New players, who were accepted immediately as members, but who have not played 3 comps, and have decided to not become members after all, and therefore intend to play as guests in future events, will be marked as Competitive Guests.

Proposed solution

• Add a new virtual field called _player_mem, title Player
• Display this field in place of the _player field, where appropriate
• Don't display the membership status suffix for events which are in the past. This is to allow for the fact that a player's membership status changes over time.
• This field is not associated with a post type.
• The player membership field will reduce the membership taxonomy terms to those that are necessary for determining how to charge the player as documented in the table above.
• It is the Committee's responsibility to determine the charges.

TAGS Admin > Results - created as Scheduled not Published

Results not redisplayed - due to being scheduled.
When I created the results for 25 June 2022 they were created as Scheduled with a time of 20:53.
Don't know why the time appears to be 2 hours ahead.

Course Lat and Long are not determined automatically from the post code.

The Google maps virtual field requires the latitude and longitude. This can be determined automatically from the lat and long fields.

Expected output

Lat and long set automatically from post code when Course is saved.
Google map virtual field shows something useful.

Actual output

Lat and long left blank.

Proposed solution

See solution for dws, a private repo. https://github.com/bobbingwide/dws

Note: If the WordPress SEO meta description is not set then the Google map can still go funny.

Add media queries for printing of the Players table

For every event we need an up to date list of the players so that we can

• check who's entered the birdies competition
• tick off the players attending the next competition
• and make other updates - such as attending the Presentation evening

It'd be nice to be able to do this quickly and easily. It probably doesn't matter about the stuff that surrounds the players table.

Add [tags_results] shortcode to display summary results - Winner and Runner up for each event in the year

I started developing the [tags_results] shortcode a long time ago but didn't implement it because I found another method.

Requirements

[tags_results year=2021]

Date	Event	Winner	Runner up
24 Apr	Dummer	Bob Unwin 36pts	Martin Hawker 35pts
24 May	South Winchester	Gary Wicks 33 pts on countback	Mick Yates 33 pts on countback
etc...

• Show Event date, Event Title / course, Winner and score, Runner up and score in a table.
• Order by date ascending
• Show Event date, event title, Winner and score and Runner up and score in a table.
• Use year= parameter to choose the year.
• Find a way of avoiding team comps or prizeless comps. eg exclude= parameter

Proposed solution

• Re-use the [results] shortcode to display the results for 2020 and 2021.

Nice to have:

• Implement as a block

Add support for PHP 8.1, PHP 8.2 and PHP 8.3

Deprecated: Calling get_class() without arguments is deprecated in C:\apache\htdocs\wordpress\wp-content\plugins\tags\includes\class-tags-content.php on line 46

TAGS Admin > Competitors and Results not showing last value added on redisplay

I've noticed this a few times this year. When entering the results the last entry is not redisplayed. This has led me to create multiple entries for the same result. Normally a birdie.

PS. I also note that it doesn't work for Competitors.

Workaround

• Refresh the display before continuing to enter additional results

For NTP's - cater for holes numbered 1 to 27 - for 3 9-hole loops

Each event has a multiple select list for NTPs. Dorset G&CC number their holes from 1 to 27. We should be able to reflect this on the website.

Improve display of Player to show Results and Attendance history

The Player post currently displays any description and [bw_fields].
We would also like:
Roll of Honour: where the result was Winner, Runner up, Third
Then NTPs and other awards.
Can we get away with [bw_related post_type=result] ?

Plus Event history showing the Competitions the player was registered for.
For past comps this needs to be ordered by Event date desc.

Fatal error when packaging the genesis-tags theme

When running oik-tip to package the genesis-tags theme the 'batch' logic in tags.php kicked in and failed with the following message.

Fatal error: Uncaught Error: Call to undefined function 
oik_batch_load_cli_functions() in 
C:\apache\htdocs\tags\wp-content\plugins\tags\tags.php:48

The logic to attempt to call oik_batch_run_me() is no longer necessary.

Support PHP 8.1 and PHP 8.2

Update code to run without problems in PHP 8.1 and 8.2

See bobbingwide/bobbingwide#103

Improve display of the Players page

Use some CSS to nicely style the name and membership type for each member, with a larger image than the 150px thumbnail.

Display players for an event in alphabetical order

When I added the players for Feb 2024 I did it one at a time.
The players aren't shown in alphabetical order.

Add logic to display total players for an event and suggest how to draw the tee times.

On the players tab we use the [bw_group] shortcode to summarise the player statuses.
Bob wants to see the total of Yes + Buggy
And I'd like to know how many to allow for taking into account TBC's.
And what the draw should be.

Improve initial Event selection on TAGS admin pages

For Competitors the Select the event selection list should default to the current/next event.
For Results the Select the event selection list should default to the previous/current event.

Also, fix any deprecated messages due to renaming of include files in oik.

Results displayed in local development environment aren't in the expected order

I recently imported the database back into a local development environment.
When viewing the results tab for an event they're not in the expected order.

Here's a subset for 7 Dec 2019

They're fine on the production server.

https://www.anchorgolf.com/event/7-dec-2019-chichester-tower/

Support entry and display of players who have requested buggies

For a while now there have been 6 or so players who have requested buggies and we've managed this manually.
For 2022 I want to add a new term that indicates if a player is playing and wants a buggy.

Improve display of Events which aren't actually competitions

When an event is not a competition then we don't expect to display content in the Results tab.

We may however display the Players for such things as AGM.

Rather than have an event_category we can determine what to display based on the related content.

Also, change some of the fields adding an option #theme_null => false which will prevent the label from being displayed when the field value is null.