Convention Website Rotation Support

NOTE: As of ~7/25/21 — in accordance with Area 10 Convention Guidelines, the decision as to whether to utilize a convention website and how that website is to be built (e.g. whether or not to use a WordPress platform, how payments are processed, etc.) are left to each Convention committee. While there are suggestions about the website and a growing body of experience, there still seems to be a high degree of variability and exercise of autonomy between convention committees and their Committee Chairs and Convention Web Chairs. Some have offered suggestions as to how to improve or change processes and decisions regarding developing and maintaining convention websites but, to date, there have been no Area 10 actions on this.

NOTE: Includes suggestions from Stewart as of 09/29/22 —

Following is the general process used for about the past 4-5 Convention Committee rotations to set up and launch the Area 10 (Colorado) Convention Website used for the promotion and registration of the convention. An overview is as follows:

  1. Create a “seed” for the new convention website (this is usually a copy of the previous year’s website)
  2. Launch that seed Website in a “sandbox” area for development
  3. On the Saturday evening of the Convention, move the existing convention site to a place where it will not be the public facing website (should still generally be operational should the last year’s convention committee need to get information from the registrations)
  4. The fully developed, tested, new website is copied from the sandbox into the production website and made active (accepting “real” registrations and credit card transactions are turned on)
  5. Verify that the new site is working as desired

Presumptions:

  1. There is a WordPress admin login (usually coaa-admin2) on all sites which is assigned to the Area 10 webchair  – recommended in case there is maintenance required on the hosting service which is maintained by the Area 10 webchair
  2. The initial site setup is being done by the Area 10 webchair (or designate) who will have at least Cpanel (hosting admin tools) access to the webhost (as of 7/21, this is hostmonster.com).
  3. Costs for any special plugins, themes or other charges will be born by the Convention Committee in their budget
  4. The convention will need to set up a Stripe.com account which links to their bank account. From that setup, you will get software keys for both “live” and “test” interfaces to the Stripe API.

Detailed steps are as follows (to simplify explanations, we are presuming that the 2022 convention is the new site and the 2021 convention is the current year convention).

  1. Set up “sandbox” for the 2022 convention
    1. determine the “seed” to be used (for our example, the 2021 convention)
    2. login as admin on the 2021 site and make a copy of the site (we’ve used the “Duplicator” plugin to do this in recent years)
    3. download this package (installer and backup file) to your computer
    4. create a new directory 2022 on the webhost under ~www/convention-sandbox/
    5. upload the package (installer and backup file) to this new directory
    6. using Hostmonster Cpanel, create a database and privileged database username and password associated with that database
      1. chose a name (limited to ~8 characters)  which would give some idea as to what it contains like “cv22sb”
      2. record the name, username and password
        1. note that on Hostmonster (and some other hosts?), there will be a prefix added to your names so that cv22sb is actually an external name of coloraj1_cv22sb
    7. Run the installer uploaded above by entering the URL of:
      https://coloradoaa.org/convention-sandbox/2022/installer.php (note that the name “installer” might be different from your installation in that, if you’ve downloaded other backups, it might be actually named something like installer(2).php)

      1. when prompted, enter the database information (DB name, DB user name, DB user password) created above
      2. test that there is connectivity to the database via the installer script
      3. when prompted for the site name, rename it to “TEST – 2022 Area 10 Convention”
    8. Upon successful install:
      1. login at:
        https://coloradoaa.org/convention-sandbox/2022/wp-admin
        to the coaa-admin2 account and complete initial setup and remove the install scripts
      2. delete all entries in the registration database
      3. make sure the registration plugin points to the proper Stripe account (or is at least disabled from the 2021 Stripe account)
      4. delete all user accounts
      5. Create a new admin user account for the 2022 Convention webchair
    9. Pass credentials to the 2022 convention webchair and fix anything that might be broken…
  2. On the Saturday night at the Convention
    1. log into the current convention website at:
      https://coloradoaa.org/convention-sandbox/2021/wp-admin
      as coaa-admin2 account
    2. create a new Duplicator (backup) package
    3. Download that package (installer and backup) to your computer
    4. create a new directory 2021 on the webhost under ~www/convention-old/
    5. upload the package (installer and backup file) to this new directory
    6. using Hostmonster Cpanel, create a database and privileged database username and password associated with that database
      1. chose a name (limited to ~8 characters)  which would give some idea as to what it contains like “cv21old”
      2. record the name, username and password
        1. note that on Hostmonster (and some other hosts?), there will be a prefix added to your names so that cv21old is actually an external name of coloraj1_cv21old
    7. Run the installer uploaded above by entering the URL of:
      https://coloradoaa.org/convention-old/2021/installer.php (note that the name “installer” might be different from your installation in that, if you’ve downloaded other backups, it might be actually named something like installer(2).php)

      1. when prompted, enter the database information (DB name, DB user name, DB user password) created above
      2. test that there is connectivity to the database via the installer script
      3. when prompted for the site name, rename it to “OLD – 2021 Area 10 Convention”
    8. Log into the old site as coaa-admin2 at:
      https://coloradoaa.org/convention-old/2021/wp-admin

      1. insure that all seems sane (can get access to old registration records, etc.)
      2. make sure that there is no “live” access to Stripe for charging credit cards
    9. Using Cpanel, move the directory from ~www/convention to ~www/convention-2021-SAVE
    10. Create a new directory ~www/convention
    11. Log in as coaa-admin2 to the 2022 sandbox site at:
      https://coloradoaa.org/convention-sandbox/2022
    12. create a new Duplicator (backup) package
    13. Download that package (installer and backup) to your computer
    14. upload the package (installer and backup file) to the directory ~www/convention
    15. using Hostmonster Cpanel, create a database and privileged database username and password associated with that database
      1. chose a name (limited to ~8 characters)  which would give some idea as to what it contains like “cv22”
      2. record the name, username and password
        1. note that on Hostmonster (and some other hosts?), there will be a prefix added to your names so that cv22 is actually an external name of coloraj1_cv22
    16. Run the installer uploaded above by entering the URL of:
      https://coloradoaa.org/convention/installer.php (note that the name “installer” might be different from your installation in that, if you’ve downloaded other backups, it might be actually named something like installer(2).php)

      1. when prompted, enter the database information (DB name, DB user name, DB user password) created above
      2. test that there is connectivity to the database via the installer script
      3. when prompted for the site name, rename it to “2022 Area 10 Convention”
    17. Presuming success, log in as coaa-admin2 to:
      https://convention.coloradoaa.org/wp-admin

      1. in order for this to work, you may need to do a “hard refresh” on your browser. On Chrome, this is a CTRL/CMD+Shift+R.
      2. sometimes, the host will also need to flush it’s cache (sometimes takes a few minutes)
      3. make sure you’re looking at the  new (2022) website
      4. Check for initial sanity
    18. Turn over to the 2022 Convention Website Chair to make sure all links are working and that registration works
    19. Verify that Stripe account is linking and Credit Cards are getting processed
  3. Depending on committee and convention webchair preferences, they may or may not want to keep their sandbox live for an active convention website should they want to test or do additional development
  4. It’s recommended that the Area 10 webchair keep copies of all packages for at least a few months in case there is a disaster or a hack. As the site is used for the active convention, there are a few recommendations to the convention committee:
    1. Maintain the admin account of coaa-admin2 on the site. Should you find the need to reset the password on that account, make sure the Area 10 webchair is given the new password.
    2. The convention webchair is responsible for all security and backups on the convention web account. Please make at least monthly backups (especially when registrations are more active toward the time of the convention).

 

 

Posted in Uncategorized | Comments Off on Convention Website Rotation Support

2020 Webmaster hand-off punch list

Tasks to complete as a part of Webmaster rotation:

  1. Get site current with updates, etc.
  2. Set up login for Stephanie
  3. “Fix” problems with Duplicator plugin
    1. Uninstalled and re-installed plugin an still unable to see a list of successfully built packages. Items indicate “seeing” packages but not able to display list…
    2. Posted question to Duplicator support forum.
  4. Set time for hand-off meeting
  5. Hand-off meeting…
    1. Passwords in Box – update for convention sites
    2. Support stuff
    3. Theme – how is matomo hooked in?
    4. Translation
    5. Plugins
    6. Duplicator
    7. Draw Attention image map for District Maps
    8. Events in Calendar
    9. Wordfence
    10. Montomo – figure out where it’s at in terms of working
Posted in Uncategorized | Comments Off on 2020 Webmaster hand-off punch list

Notes on Setting up Duplicator

Installed Duplicator plugin but did not have ability to add packages due to “export” capability off from Administrator Role.
Added User Role Editor plugin to change this role.

Posted in Site Maintenance | Comments Off on Notes on Setting up Duplicator

Site Analytics – Matomo

As a part of the 2017-18 rotation, the Web Chair was requested to provide more information in her reports about site usage. Typical information requested include:

  1. How many times the site is visited?
  2. Where people are from who are visiting the site?
  3. What parts of the site are people visiting?
  4. etc.

Past rotations have used tools available from the web hosting service (currently Hostmonster.com) such as Webalizer and Awstats to provide reports but, since they are based only on Apache access logs using parsing tools and heuristics over which we have little or no control, the reports seem to vary widely in reported numbers and information.

Currently, the best “free” analytics package on websites such as Area 10’s would be Google Analytics but this requires placing some software on each page that communicates with and runs on a Google server. While there are assurances that this tracking is generally anonymous (no personal identifying information is tracked by Google), lots of stories exist of individuals believing that Google is “following them” on the web and there is a possibility that using the Google Analytics interface could provide data that could associate a given visitor to coloradoaa.org with other web browsing activities.

Rather than either debating the potential use of Google Analytics at Area 10 or attempting to definitively “prove” the security using this tool, we put a post up on tiaa-forum.org to ask other AA entities what they were doing with (or rationales for not dealing with) Google Analytics.

We found out from responses to that poll that AAWS/GSO are using a tool called Matomo (previously called Piwik) for analytics in order to collect analytics information similar to Google Analytics and get around the issue of sending data to Google since, by running the service on our own server, data will only exist in the domain of control of coloradoaa.org (data will be collected by and stored on our own hosting account – currently at Hostmonster) and the Area 10 Web Committee.

Lew Grothe installed the server and tested it on another Hostmonster instance that was under his control. Based on that preliminary success, he set out to install the software on the coloradoaa.org hosted account.

These are the steps required to set that up:

  1. Set up a subdomain instance for matomo.coloradoaa.org which points to a directory of ~/public_html/matomo
  2. Download the software from matomo.org into it’s root directory (~/public_html/matomo)
  3. Install the software
    1. the software installs automatically when you browse to: https://matomo.coloradoaa.org/piwik/
    2. the software checks the system for compatibility. It requires a different setting for one PHP parameter than the Hostmonster default so we needed to copy a php.ini file into the directory where the script is run (~/public_html/matomo/piwik/) with:

      always_populate_raw_post_data = -1

    3. set up a new database and user using cpanel and tie that to matomo as a part of the installation
    4. create the administrative user for matomo:
      user name: matomo-admin
      pw: bM6gP7G3jJS
    5. Log into the server using the admin account and set up a user account for looking at and managing coloradoaa.org statistics:
      user name: coaa-matomo
      pw: Q62kPp3tgrj

Setting up tracking for the site

The “tracking code” is the Javascript that appears on the page that calls the server (in our case at matomo.coloradoaa.org) to log information when a browser “hits” a page on our site. There are several ways to accomplish this:

  1. The Piwik tracking plugin. This plugin is minimal (supports tracking code only on specified pages) and, as of 3/19/18, has 4,000+ downloads with a high rating and has been tested on our current release of WordPress.
  2. The WP-matomo plugin. This plugin is well featured (includes more powerful tracking options as well as reports from the server) and, as of 3/19/18, has over 70,000 downloads with a very high rating. While it’s not tested with our current WordPress release, it has passed tests with the previous release and seems pretty well supported.
  3. Various header/footer insertion plugins. There are several and a few are popular and tested with our current version of WordPress. The simplest of these are free and offer very simple functionality for inserting the requisite code.
  4. Edit the header.php in the theme (Appearance->Editor). This has the disadvantage in that, if there’s an update to the theme, you will need to remember to add changes back into the file. As the current theme in use (Smpl Skeleton) seems to no longer be supported, this may not be an issue.

For at least a “trial phase,” we will opt for the option of editing the header.php file.

The tracking code for coloradoaa.org is located under the matomo.coloradoaa.org Matomo admin site.

Update 2018/03/23:

I added the cities database for tracking per Matomo->settings->system->geolocation. Reading around on the MaxMind (provider of the IP address to city location database) website, it would appear that the free version of the cities database will no longer be distributed after 4/1/18 and will be removed completely by 2/1/19. Bummer. We will need to plug into the Matomo community and see if there will be another way of supporting this sort of IP->city mapping. One would expect something to be available soon.

After setting this up, I had to rebuild the database archives for the existing reports on existing data using the tools contained here.

Posted in Site Maintenance | Comments Off on Site Analytics – Matomo

Problems with calendar in spanish

Behavior 1

  1. Click Spanish on any other page
  2. Go to Calendar
  3. Navigate anywhere from current page

Seems to remain in Spanish as one would expect

Problem 1

  1. Go to calendar (English).
  2. Click Spanish
  3. Navigate to other months

Results seem to always come up English

Problem 2

  1. Go to calendar (English)
  2. Navigate to another month
  3. Click Spanish

Result is to bring up original month in Spanish and navigating to any other month returns you to Spanish

 

Posted in Issues | Comments Off on Problems with calendar in spanish