=== GolfSoc ===
Contributors: Malcolm-OPH
Donate link: http://www.corondeck.co.uk
Tags: golf, competition
Requires at least: 3.0
Tested up to: 6.7.1
Stable tag: 1.6.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The GolfSoc plugin provides player, score and handicap management for Golf Societies

== Description ==

A shortcode added to a Page on the website outputs a summary page for a player.
From here links allow the player to view their competition, score and handicap history.
Further links allow the player to view the complete competition and scores history.

Features Summary

* Keeps records of players, competitions, scores and handicaps
* Handicap Calculation using simplified version of WHS 
* Uses Course Rating, Slope Rating and Par for handicap calculation
* Sends personalised EMails for Playing Handicap and Results
* Creates individual logins for each player (as they are added)
* Supports Players that do not (currently) have an EMail address
* Players can edit their own contact details using WP Profile editor

== Limitations ==

* Only 18 hole Stableford competitions are supported
* Simplified WHS Handicapping
* Handicap Calculations NOT authorised by any golf governing body

== Installation ==

First Time Installation

* Download the plugin archive
* Open the Wordpress Dashboard for your site
* Click "Add New" under the "Plugins" menu 
* Select the "Upload Plugin" option 
* Under "Install a plugin in .zip format" browse to the plugin archive file you downloaded
* Click Install Now.
* After it has installed, activate the plugin.

Manual Upgrade/Update

* On the WP Plugins Page deactivate (but do <span style="text-decoration: underline;">NOT</span> delete) the current golfsoc plugin
* Using FTP (or your ISPs file manager) delete the current golfsoc plugin folder in the wp-content/plugins folder
* Now Proceed as for the First Time Installation

== Frequently Asked Questions ==

= How are the handicaps calculated? =

* Handicaps are calculated by taking an average of the best scores from a number of recent scores. 
* The number of scores averaged and the number they are selected from can both be specified in the plugin settings. 
* Where a player has less scores that the number of scores averaged then all their scores are avaraged to calculate the handicap. 

= Do you offer support? =

* The author has created this plugin for their own golf society, and published in the hope that it will be useful for others. 
* Users are welcome to report bugs and suggestions for improvemnets, but the author cannot provide site specific support.

== Screenshots ==

1. Screenshot 1: Overview Page
2. Screenshot 2: Players Admin Page
3. Screenshot 3: Courses Admin Page
4. Screenshot 4: Competitions Admin Page
5. Screenshot 5: Handicaps Admin Page
6. Screenshot 6: Tools Admin Page
7. Screenshot 7: General Settings Page
8. Screenshot 8: Golf Settings Page
9. Screenshot 9: EMail Settings Page
10. Screenshot 10: Page Template Settings Page
11. Screenshot 11: Player Summary 
12. Screenshot 12: Handicap History 
13. Screenshot 13: Competitions Record 
14. Screenshot 14: Competition Results 
15. Screenshot 15: Course Rating 
16. Screenshot 16: Playing Handicaps 

== Changelog ==

= 1.6 (15/04/2025) = 
Added Check for "Rogue" script tags

= 1.5 (06/01/2025) = 
Option to enter hole scores added 
Competitions list split into General Play Rounds and Competitions
Added Fixtures Secretary EMail Address 
Added Online Sigup for Competitions option 
BCC emails to fixtures sec when adding fixtures  
BCC emails to fixtures sec when player enters/withdraws  
Summary page reformatted
Added GOLFSOC_CAPABILITY_ADDCOURSES 
Signup template improved
Bug Fix: Summary code fails if no next competition entry
Bug Fix: General Play without tee selected generates error 

= 1.4 (11/10/2024) = 
Force Numeric keypad for score inputs
All numberic entries now of type "number" 
Move to PH Entry after changing tee 
Bug Fix: Course Name update fails 
Now checks course exists when updating details 
Added playerName field to SELECT queries that contain first and last names 
PHP $tsFormat global set to regional time/date format 
Added compDateTime field for competition date & time in straight text format 
Bug Fix: '[if...] within [ifdef ****][else][endif] fails in templates

= 1.3.10 (21/08/2024) = 
Bug Fix: Status field in Add Scores page incorrectly formatted
Added "General Play" Scores

= 1.3.9 (23/08/2024) = 
Added Max & Min values for CR and Sr to settings 
Fixed typo in templates (andd to and) 
Added score status to results 
Force update templates on activation ($justActivated refers) 
Bug Fix: Fixture Labels do not print correctly

= 1.3.8 (23/08/2024) = 
Added user_login to email templates (so users with the same email address can login) 

= 1.3.7 (28/06/2024) =
Added Countback values to Score Checker

= 1.3.6 (26/06/2024) =
* Bug Fix: Par and SI entries should be "trimmed"
* Bug Fix: Handicap Calculations including N/R and D/Q entries

= 1.3.5 (12/03/2024) =
* Added Admin Message option to emails 
* Up/Down arrows removed from scorecheck entry boxes 
* Added extra "Out" total after hole 9 to score checker 

= 1.3.4 (25/02/2024) =
* Added no of shots to scorecard labels 

= 1.3.3 (16/01/2024) =
* Bug Fix: Send EMails button not hidden when sending PH EMails 

= 1.3.2 (16/01/2024) =
* Bug Fix: PH EMails not sent 
* Bug Fix: Duplicated inline Javascript (since 1.3) 

= 1.3.1 (15/12/2023) =
* Bug Fix: Duplicated inline Javascript (since 1.3) 

= 1.3 (14/12/2023) =
* Bug Fix: Extra labels printed when players count not multiple of 4
* Added Out and In totals to score checker
* Added "EMail Results" button to competitions page
* Tested with WP 6.4.2

= 1.2 (09/10/2023) =
* Added (optional) hole Pars and SIs to tee details
* Added Stableford score checker
* Added Attendence admin page
* Bug Fix: <br> shown in course details edit

= 1.1 (10/08/2023) =
* Added support for Non-Return rounds 
* Tested with WP 6.3

= 1.0.7 (19/07/2023) =
* Further updates for PHP 9 Compatibility

= 1.0.6 (14/07/2023) =
* Updated to prevent null string errors in PHP 9
* All echo calls now escaped before output (uses Safe_Echo() function)
* Handicap Archive page now shows expired entries in blue italics
* Added Players Scores, Handicap History & Playing Handicap Exports

= 1.0.5 (15/03/2023) =

= 1.0.4 (15/03/2023) =
* Added Postcode, Phone and What3Words to Course Details
* Scores now only published once competition is closed
* Added "Edit Course" function

= 1.0.3 (12/03/2023) =
* Bug Fix: Playing Handicaps Template always says "Active Players"
* Added (optional) competition details to "Add Competition" adnin pages

= 1.0.2 (09/03/2023) =
* Bug Fix: Bulk Action and Page Navigation elements not on same line
* Added PH to Handicap Archive template 
* Close Competition button on Add Scores page closes comp then prompts for results email notifications
* Added "Holes" to Tee Details on Courses Admion Page
* Added "SD" to handicap archive page template

= 1.0.1 (05/03/2023) =
* Bug Fix: Invalid URL in emails 
* Added scores export to tools admin page

= 1.0 (18/01/2023) =
* First release