Differences

This shows you the differences between two versions of the page.

--- admin_tools [2024/05/27 10:02] – [How eventcount handles the "volunteer", "performer", "open band" Ticket Types, etc] wikiadmin
+++ admin_tools [2025/05/24 09:36] (current) – [How eventcount handles the "volunteer", "performer", "open band" Ticket Types, etc] wikiadmin
@@ Line 1: / Line 1: @@
-======Some Admin Tools that run on fsgw2.org======
+======FSGW Admin Tools, that run on fsgw2.org======
   * [[https://fsgw2.org/tools.html|Admin Tools index page]]
@@ Line 5: / Line 5: @@
 =====Admin Tools access control=====
-There is no access control on our Admin Tools index page, anyone can view it: [[https://fsgw2.org/tools.html]]
+For the tools that require login, use your fsgw.org email address and password. Login uses the OAuth 2.0 protocol, so the actual login page is on fsgw.org, while the admin tools run on fsgw2.org. If login does not respond (the page stays empty) within 20 seconds after you click the 'Log in' button, the problem is probably that the login page had been displayed too long and so aged out. Back up to the login page (it has Email and Password fields) then reload it, such as by clicking your browser's circular arrow button (often near the top left), then try to login again.
-For the tools that require login, use your fsgw.org email address and password. Login uses the OAuth 2.0 protocol, so the actual login page is on fsgw.org, while the admin tools run on fsgw2.org. If login does not respond (the page stays empty) within 30 seconds after you click the 'Log in' button, the problem is probably that the login page had been displayed too long and so aged out. Back up to the login page (it has Email and Password fields) then reload it, such as by clicking your browser's circular arrow button (often near the top left), then try to login again.
+Access to use the tools is given by setting "Group participation" on a Contact's "Membership" tab in Wild Apricot (WA) "Admin view". There is a somewhat long list of groups, where you check off the ones a member should be in. The discussion below refers to Group names.
-Access to use the tools is given by setting "Group participation" on a Contact's "Membership" tab in Wild Apricot (WA) "Admin view". The discussion below refers to Group names.
+Because WA only supports groups for members and we have needed to give tools access to non-members, we added the "Access Group" contact field, which is in "Internal use" under "Contact details". It can contain one or more group names, pipe separated, each capitalized correctly (example: "Photos|eventtools"). The pipe character: "|", is shift-backslash on many keyboards.
-Because WA only supports groups for members yet we have needed to give tools access to non-members, we added the "Access Group" contact field, which can contain one group name, capitalized correctly.  So far, "Access Group" is only used by/supported in the Event Counts and Income helper ([[https://fsgw2.org/eventcount.php]] ), ECD Schedule View Helper ([[https://fsgw2.org/ecd_events.php]] ), and E-Blast Helper ([[https://fsgw2.org/eblasthelper.php]] ) tools.
+As of 6/7/2024, "Access Group" is supported in the Event Counts and Income helper, Event Registration List helper, Apply a contact's credit to pay for an invoice, Find contacts and examine them, including looking for duplicates, ECD Schedule View Helper, and E-Blast Helper tools.
 eventtools, eventadmin, and eventdev are the 3 levels of access supported in the tools that require login, especially in eventcount ([[https://fsgw2.org/eventcount.php]], Event Counts and Income helper) and find_contacts ([[https://fsgw2.org/find_contacts.php]], Find contacts and examine them).
   * eventtools or Staff or Board Member groups allow one to use the tool and do basic things in it.
-  * eventadmin group allows seeing and doing some additional things that we think need a higher level of understanding/care. For example, in eventcount, anything that actually changes data in WA requires eventadmin or eventdev. The buttons to make changes are not even displayed unless the login has enough access.
+  * eventadmin group allows seeing and doing some additional things that we think need a higher level of understanding or care. For example, in eventcount, anything that actually changes data in WA requires eventadmin or eventdev. The buttons to make changes are not even displayed unless the login has enough access.
   * eventdev group also allows seeing and doing a few things that we think only a tool developer (Will for now) should or would want to see.
-For the "Publicity Photo collection" tool ([[https://fsgw2.org/photo.php]] ), the groups giving access are Photos or Staff or Board Member.
 In the more recent tools PHP source code, if you see a test of $allowed_level, that is checking the group level, where eventtools is 1, eventadmin is 2, and eventdev is 3.  Older tools use a simpler, more hard coded test for access.
+There is no access control on our Admin Tools index page, anyone can view it: [[https://fsgw2.org/tools.html]]
+=====About the FSGW Publicity Photo Collection and Uploader=====
+Back in 2021 Will Strang developed the FSGW Publicity Photo Collection and a Photo Uploader, at several board members' request.  The goal of the Uploader is to make it easy for performers to upload publicity photos, and the goal of the Collection is to make it easy for FSGW people to then find and use the photos.  They were used up through April 2023, mainly by Concerts.  Early in 2024, there were 90 photos in the collection, although a few were random photos added for testing.
+The Collection could just as well be used for dance caller and band photos.  It could also be used for uploading attendees photos of events, although not at full camera resolution due to the file size limit of 50 MB imposed to prevent disk-filling attacks, and not in large numbers because upload is 1 at a time.
+The "FSGW Publicity Photo Uploader" is here:  [[https://fsgw2.org/pubphoto.php]]\\
+No login is needed. It allows uploading jpg, jpeg, png, gif, or pdf files, 1 at a time.  (Any pdf file must contain an image, not just text.)  Maximum file size is 50 MB, to prevent disk-filling attacks.  It asks for some descriptive information about each file before upload.
+The "FSGW Publicity Photo Collection" is here: [[https://fsgw2.org/photo.php]]\\
+It requires logging in with your fsgw.org website login, and having the "Photo", "Staff", or "Board Members" group set for you.  It initially shows you preview images of the 30 most recently added photos, with descriptive information about each.  It allows searching for photos, and editing to correct or add descriptive information.  It can display the original file for any photo, for download.
+For the "FSGW Publicity Photo collection" ([[https://fsgw2.org/photo.php]] ), the groups giving access to it are Photos or Staff or Board Members.
+There are a number of capabilities that could be added to this Photo Collection software, if someone felt a need and asked.  I will not add on my own, someone would need to ask.  I do test it occasionally, and have fixed a few minor bugs.  Some examples:
+  * Larger photo files could be supported.
+  * Scaling a photo to a specified size for use could be supported.
+  * Bulk uploading groups of photos could be supported, with adding descriptive information later.
+  * Filing photos into groups could be supported.  This would be needed for bulk uploading.
+  * Backing up the photos into Google Photos could be supported, with at least some of the descriptive information, possibly all.
 =====How eventcount handles the "volunteer", "performer", "open band" Ticket Types, etc=====
-<text>The path to Ticket Type happiness in the Event Counts and Income helper (eventcount), is to always use "volunteer" and "performer" Ticket Types, not some combination or alternative.  And use "open band" for Open Band members.  If you need to have multiple distinct Ticket Types for volunteers or performers, make sure that each Type starts with "volunteer" or "performer", followed by whatever words make each Ticket Type more specific.
+<text>The path to Ticket Type happiness in the Event Counts and Income helper (eventcount), is to always use "volunteer" and "performer" Ticket Types for $0 fee admissions, not some combination or alternative. And use "open band" for Open Band members.  If you need to have multiple distinct Ticket Types for $0 fee volunteers or performers, make sure that each Type starts with "volunteer" or "performer", followed by whatever words make each Ticket Type more specific. If a Ticket Type has a non-0 fee, then all this is ignored even if it contains "volunteer" or "performer".
 All these string comparisons are case independent, so "volunteer", "VOLUNTEER", "volunteers", "VOLUNTEERS", "volunteerS", and "VOLUNTEERs" all match, etc.
@@ Line 49: / Line 70: @@
 "talent/staff" is treated like "performer" because #Dance wanted to use it.  If you use "talent/staff", spell it exactly, do not add any spaces around the slash ("/").
-A clarification:  If an event has volunteer Ticket Types that are not free (have a fee above 0), such as #dance has had, then they will not get this special handling, and there's no use in making those Ticket Type names start with "volunteer".  Only Ticket Types with a fee of 0 can get it.</text>
+A clarification:  If an event has volunteer Ticket Types that are not free (have a fee above 0), such as #dance has had, then they will not get this special handling, and there's no impact from making those Ticket Type names start with "volunteer".  Only Ticket Types with a fee of 0 can get it.</text>
+=====Uploading Board Meeting Minutes and Summaries=====
+To upload a FSGW Board Meeting Summary PDF file:
+  - Go to https://fsgw2.org/minutes/upload.php
+  - Login with your fsgw.org login and password.
+  - Only those with the "Board Members" or "Staff" group assigned may use this tool.
+  - Enter the Year, Month, and Day of the board meeting.
+  - If it was a Special Board Meeting, check the Special Board Meeting checkbox.
+  - If it is a Meeting Summary, check the Meeting Summary checkbox.
+  - Click the "Browse..." button next to "Select the Minutes or Summary file:", which will display a dialog to Open (or Select) a file.
+  - Find the file to upload and select it, then click the "Open" (or Select) button at the bottom of the dialog, which closes the dialog.
+  - Click the "Upload selected file" button.  The file should get uploaded.
+  - On success, the Upload web page will re-display, and the newly uploaded file should now be visible in the list at the bottom.
+  - If an error is displayed and you cannot figure out what to do about it, then contact a FSGW webmaster.