Jobs up and running on the Demo Site

I have update the wp-SwimTeam demo site with a preliminary version which includes the new jobs module.  I expect I will release it over the weekend at some point.   You can see what a sample page or post would look like for a swim meet.  From the Administrative perspective, a similar report is available but includes more details (e.g. phone numbers).

I had a chance to show this to the woman who coordinates volunteers for the MacDolphins and she was pretty excited about it.  It should make her job much easier and it will also make it much easier for parents to know when they have signed up to volunteer.

I want to do a little more testing on it before I release it but I am pretty confident it is working pretty well.

Jobs module is almost done

This past week I have made quite a bit of progress on the jobs module.  Everything seems to be working, I just have some polish and testing to finish up before I will release it.  The basic job work flow works like this:

  1. Define a job – title, description, duration, etc.
  2. Allocate a job to a season or to one or more swim meets.  This action connects a job to a specific season or meet and defines the number of positions required.
  3. Assign job ownership.  This can be done by either the administrator or by end users themselves.  End users cannot assign themselves jobs which are already assigned to another user.  An administrator can change the assignment of a job from one person to another.  Job assignment can be performed in couple different ways:
    • Full or Partial Season long jobs can be assigned from the Seasons tab.
    • Full or Partial Meet long jobs can be assigned from the Swim Meets tab.
    • A specific job can be assigned from the Jobs tab.

The Swim Meet Report has been enhanced to include a Job Assignment section and a new short code has been defined to allow a meet specific job report to be added to a page or post easily.  The wp-SwimTeam demo site will be updated shortly to show some of the new features.

Export Roster to Meet Manager

If you have followed my posts on this blog you know that I have been frustrated by Hy-Tek Team Manager and Meet Manager along with Hy-Tek customer support.

While I may not care for Hy-Tek or their products, the fact is they have a dominant market share and a lot of teams use Team Manager, Meet Manager, or both.   I was  contacted this week by a high school coach who was looking for some SDIF assistance in getting his roster into Meet Manager.  Now I don’t have access to Meet Manager but I do have pretty good understanding of the SDIF specification so I was able to help him out with some example SDIF files.

In the process of helping him out I came across an old e-mail regarding importing a roster into Meet Manager.  At the time I was interested in Team Manager so didn’t give it a lot of thought.  Looking at the old e-mail I realized that if it worked, I could export the file format very easily from wp-SwimTeam.  I went ahead an implemented it, now I am looking for someone to try it out.

Sample Reports

Download Sample Exports Version v1

The zip file above contains three versions of the same roster – CSV, SDIF (.sd3), and Meet Manager Registration (.re1).  Extract the Meet Manager Registration file from the zip file.  It is an ASCII file that contains swimmers records, one per line with the following fields delimited by semicolons:

  1. Registration number
  2. Last name
  3. First name
  4. Middle initial
  5. Sex
  6. Birthdate
  7. Club abbreviation
  8. Club name
  9. Preferred first name
  10. ?? – unknown what this last field is; it’s always “N” in the examples provided

To import the file into Meet Manager, follow these steps:

  1. Set up a new meet database.  You only need to go through the first setup screen, the one where you put in the meet name, date, and length of course.  To make my particular file work, select “USA Swimming” for the ID format.  If you have something other than USA Swimming numbers for swimmer labels, select “Other”.  Normally, for a kids’ meet, you’d select “USA Swimming” for the ID format or “Other” if you are not using USA Swimmer numbers for simmer labels.
  2. From the main Meet Manager menu, select “FILE”
  3. Select “IMPORT”
  4. Select “REGISTRATION FILE”
  5. Locate and choose the .RE1 file that contains the roster.

After completing these steps, go to the “Athletes” screen in Meet Manager.  The swimmers contained int he RE1 file should bYou should see all of the athletes’ names that you saw in the RE1 file.

If this works for you, please leave a comment!

Volunteers progressing

Over the last couple of days I have finally made some visible progress on the Jobs module. I am still not wild about the term “allocate” but it is the best I have come up so I am proceeding with it.

At this point I am able to define jobs, allocate a job and quantity required against a swim meet and make some refinements of the allocation. I also have the beginning of the assignment to a specific user GUI done but not the backend functionality. I am optimistic that I may finish a first pass this weekend.

DocBook to PDF?

I spent some time this afternoon writing some content in DocBook format using a tool called XMLmind XML Editor. I am using the free Personal Edition. I like the editor, it was quick to learn and works as advertized. After writing a couple pages I decided to see how it looked as a PDF file.

It turns out that turning DocBook into PDF isn’t as easy as I thought it would be.  I have yet to find a good solution.  I may have to buy the full version of XMLeditor.

wp-SwimTeam documentation?

Like a lot of projects, documentation for wp-SwimTeam is severely lacking.  It has been on my to-do list for a long time and I have been thinking about it recently.  I was heading down the Wiki route recently and actually got one set up.  I’ve never been a big Wiki fan but I do see their attraction for certain types of projects.

I personally prefer “real” documentation and by “real” I mean something you can print and read away from the computer.  I’ve always like the model that used by Version Control with Subversion has used.  The source is in DocBook format which means it can easily be produced as web pages, a PDF file, or an actual book.

Right now I am leaning toward using the DocBook format.  At a minimum I am going to try it and see how it goes.  Stay tuned!

Early WordPress 3.0 testing

WordPress 3.0 is expected to be out sometime in May.  I figured I ought to do some basic testing to see if changes to WordPress would have any significant impact on wp-SwimTeam.

I have a Linux Virtual Machine which I have set up such that I can always run the bleeding edge of WordPress – right out of the Subversion repository.  When a new version of WordPress is ready to come out I update my Linux VM with the current state of WordPress and the current state of wp-SwimTeam and run some tests.

I started doing this a couple weeks ago and got busy and never finished it.  This morning, I got back to it.  It turns out, it didn’t run very well.  Both wp-SwimTeam and phpHtmlLib plugins were calling deprecated WordPress functions.  In releases prior to 3.0, there were no warnings about calling a deprecated function but 3.0 has a new warning feature.  The way it is implemented, the warnings actually caused a failure with phpHtmlLib which resulted in WordPress not successfully loading.

I have fixed the problems in both plugins and committed the changes.  However, I have not released new builds yet so until I do, I advise sticking with the 2.9.x release of WordPress.  I expect a new build later this week at the latest.

Working out volunteer management

I had done some work on volunteer management last year but put it aside to focus on other features.  I have picked it back up and found that one of the assumptions I had made last fall was completely wrong.

I concluded over the weekend that volunteers is three phases:

  1. Definition of volunteer roles which are referred to as “Jobs” within wp-SwimTeam.  The definition of a job includes the title, description, type of job, duration, where it is needed (home, away, both), and a few other details.
  2. Assignment of jobs to a season or meet.  Some jobs span a season, some are only for a meet.  The number of people needed to fill the jobs will differ from team to team and from pool to pool.  You might need 3 timers for a 6 lane pool but 4 for a 8 lane pool (assuming each team provides half the timers).
  3. Assignment of people to the jobs.  Once all of the jobs are defined and allocated for each meet and season, people need to sign up (or be assigned) to the jobs.  Initially I expect to only implement assignment and will add sign up later.

I’d be curious to know if anyone can think of a scenario that this won’t work for.  I’ve got phase 1 completed already and will start on phase 2 this week.

wp-SwimTeam v0.1.456 now available

Quick turn-around on a release as there was a bug which was really bothering me.  The Opt-In/Opt-Out report was pulling swimmer label from the active season regardless of which season a meet was created against.  This was fine for the current season but messed up reports from any prior season.

The report now pulls swimmer labels from the season that the meet is created against so looking back a a report from last season or two seasons ago will still show correctly.