Download & Installation
Requirements
The wp-SwimTeam plugin will only work (for now, subject to change) with WordPress 2.7 3.0.xand later. Development is currently being done against WordPress 2.9.2 3.0.5 3.1.1 3.1.2 3.1.3, using 2.9.2 3.0.5 3.1.1 3.1.2 3.1.3 will likely yield the best results.
Disclaimer
The wp-SwimTeam plugin is very much in a state of active development right now so there isn’t a real formal release and download mechanism in place yet. Zip files will be made available from time to time, usually when I update the wp-SwimTeam Demo site.
To use the plugin (and you are welcome to do so), either download a snapshot from this page or obtain the latest source from the Subversion (aka SVN) repository. The snapshot zip files are relatively stable, the SVN source may not be.
Downloads
wp-SwimTeam plugin – updated 6/27/2011 @ 11:40
phpHtmlLib plugin – updated 4/12/2011 @ 20:15
Subversion Repository
To obtain the latest version from Subversion, use the following Subversion command:
svn export https://wp-swimteam.svn.sourceforge.net/svnroot/wp-swimteam/plugin/trunk wp-swimteam
This will export the latest version (aka trunk) of the plugin to a directory called wp-swimteam. The plugin is dependent on the 2_X_X thread of phpHtmlLib however it makes use of code which is in the phpHtmlLib respository but hasn’t been released yet. Similarly, you will need to get the latest version of phpHtmlLib’s 2_X_X thread from it’s SVN repository.
svn export https://phphtmllib.svn.sourceforge.net/svnroot/phphtmllib/branches/BRANCH_2_X/phphtmllib phphtmllib
Installation
The wp-SwimTeam plugin is dependent on the phpHtmlLib plugin so download and install it first.
Installation of phpHtmlLib is simple as it is now a WordPress plugin: Install it like any other WordPress plugin. Drop the plugin in the wp-content/plugins directory and activate it from the Plugins menu. The phpHtmlLib plugin must be installed and activated in order for wp-SwimTeam to run correctly.
Installation of the wp-SwimTeam plugin is simple – it is installed like any other WordPress plugin. Drop the plugin in the wp-content/plugins directory and activate it from the Plugins menu. Upon activation the plugin will create all of the necessary tables. Before using the plugin, make sure you set the various settings under the Settings->Swim Team menu.
This plugin sounds amazing!! It was exactly what I was looking for!
Would it be possible to email me a zip of it so I could try it out and let you know my thoughts on it?
Thanks,
Chris
BTW: I am a swimmer and a coach.
@Chris Goodwin
Absolutely, check your e-mail for some additional information. I’ll also try and get a ZIP bundled up and posted later today.
I am the webmaster of the website of the SHAPE Seals swim team (shape-seals.net) in the EFSL (http://www.swimefsl.org/), we probably could use your plugin (besides the existing Hy-Tek) for registrations for example. Thanks you for the hard work you have done so far!
Here is my first experience with the plugin:
- The installation was easy without problems.
- The initial configuration I had just one issue: The team is in Europe, no State here, but it was required (not really an issue).
- During the test fill I have created some meets, some parents, jobs and swimmers. I was not able to figure out which is the right configuration for the meet, because in our league there are usually 2-4 teams invited, so I set it to Invitational instead of Dual (but I do not think it matters – at least at the beginning – because we do not want to maintain the teams for the meets). Almost all of our meets are “Opt In”, i.e. the swimmers/parents have to register at the Head Coach if they attend. When I wanted to register a swimmer in the plugin (Swim Team/Swim Meets/Register) the swimmers check list was empty. The quick solution was to change the getAllSwimmerId (I removed the meat table from the select):
//$query = sprintf(“SELECT DISTINCT id AS swimmerid FROM %s, %s”,
// WPST_SWIMMERS_TABLE, WPST_OPTIONS_META_TABLE) ;
$query = sprintf(“SELECT DISTINCT id AS swimmerid FROM %s”,
WPST_SWIMMERS_TABLE) ;
I do not know that my configuration was/is wrong or the registration should be used in a different way, but the above change solves the empty swimmer box problem.
But I had another problem with the meet registration: The swimmer is registered just for a stroke (or event type) and not a real event: For example instead of 50 FR (Girls 9-10) just Freestyle is in the dialog (Swim Meets : Register)). Is this on purpose?
Finally one more question: I have added a Job, but I haven’t found where to assign the parents to the jobs. Is there such feature, or it is under development?
Thank you again for the plugin, it is almost exactly what I was looking for.
Laszlo
Thanks for all of the feedback, I really appreciate it.
I should probably disable or hide some of the things which are still work-in-progress. The jobs (volunteers) is one of those areas that isn’t finished as is events.
The question about which event a swimmer is registered for is based on the USA Swimming specification, or at least my understanding of it. Hopefully it works for your European type meets too. A swimmer would register for a stroke (e.g. Breaststroke) and which ever Breaststroke event for their age group they are eligible for they would be assigned to. In our league we swim very few meet, usually just one, that involves more than one team.
Do you know which version you ran into the table problem with? Another team reported a similar problem which I fixed in v0.1.406 in the last day or two.
More comments when I get back home later tonight …
@Mike Walsh
I will take a look at the State or Province issue – I thought I had made that optional when the Geography was non-US. It could have slipped through though.
This plugin is very much a work-in-progress. We are just gearing up for swim season here in North Carolina so there will likely be 1-2, possibly more, updates each week through the end of July. After that our season is over and I’ll work on it but not with the same urgency. I am hopeful that by next season it will be pretty close to feature complete. That is my hope anyway!
Thank you for your comments. I have v0.1.406. Right now I am using the plugin just locally, so just take your time. The registration email for the next reason has been posted already, I don’t think it has sense to replace the entire site (we have WordPress 2.6) in the last minute. I keep testing it locally when I will have time.
Some more information about the meets in the EFSL:
The meet season is September-February, therre are a couple of invitational meets among the teams in the same division almost every weekend (we will have 16 meets). Some meets are dual, but if more teams are located close to each other, than often 3-4 teams attends a meet.
End of January there is a divisional meet (final) and in February we have the EFSL Final. To attend the final the swimmer has qualify herself/himself on one of the meet in the season.
Usually each swimmer can register up to 3 events in every meet, but there are pentathlon meets as well where everybody has to swim 5 fix events (FR,FL,BK,BR,IM).
In our team the swimmers can select the 3 events they want to swim.
My kids are 9 and they can register in (50 m FR,FL,BK,BR + 100 FR,IM+200FR,IM). For older swimmers there more 100 m strokes…
Thank you again for the good work, I will let you know if I find something.
#1 message: “this website needs a different google maps api key”
#2 I get the Key
#3 Plugin / Swim team options / miscell./ enter Key
#4 Still having the message…
Google API keys can be tricky – I had problems getting one to work for another side I worked on. Make sure the case of the URL you submitted is correct and the domain matches where you want to display it on the web. I can’t think of anything else to try. In my experience it either works or doesn’t and there isn’t much feedback from Google when it doesn’t work.
Good morning. I am hoping that your plug-in will help meet some needs of our synchro club. I am a volunteer and am looking for a registration solution. Is there an updated version? I have installed per your directions and am getting the following error when I try to activate the plug-in. Fatal error: Cannot redeclare html_link() (previously declared in /home/synchro/webapps/wordpres/wp-content/plugins/wp-pagenavi/scb/Util.php:137) in /home/synchro/webapps/wordpres/wp-content/plugins/phphtmllib/tag_utils/html_utils.inc on line 952
Thanks for your work!
Sheila -
Based on the error you are reporting, it looks like the plugin “wp-pagenavi” has defined a function called html_link() which is also defined in the phpHtmlLib plugin library. A quick temporary solution would be to disable the wp-pagenavi plugin and try it again, it should work. Off the top of my head I am not sure how to resolve two plugins defining a function by the same name, I will have to investigate and get back to you.
Mike
Mike,
Thanks for your help – your software looks amazing but it isn’t quite wheat I am hoping to find.
Sheila
The demo site says “If you are interested in exploring the demo – feel free to register with this web site as a user. ” I would like to try the demo, but do not see how I can register. Any advice would be appreciated.
Thanks,
I was getting a lot of spam registrations so I had to turn registration off. I’ll contact you via e-mail and get you set up.
Hi Mike,
I’m working on a Drupal based site and would like to be able to import meet results from Meet Manager. I’d like to be able to read meet results exported by Meet Manager and/or Team Manager. From what I can gather they output a CL2 or HY3 format. Does your plug in have a class that can handle parsing these files?
I see that it can handle SDIF files but from what I’m reading that’s not quite the same as CL2 (just enough of a difference to cause problems at times).
Could you point me to any PHP source code that can handle reading CL2 or HY3 files? I’d hate to have to reinvent the wheel.
Thanks
Ken
I’ve looked for PHP (or any other language) source code which parses Hy-tek files and came up empty. That said, the .CL2 file is almost exactly the same SDIF and if you only want to extract information from it, looking at it as an SDIF file is probably ok. The HY3 format is entirely different and requires a parser. I’d recommend joining the SDIF Google Group I created, one of the members recently published a very thorough analysis of the HYV file format and there is talk about tackling the others as well.
One of the PHP source files in my wp-SwimTeam plugin defines all of the table values in the SDIF specification – that alone would be useful for processing a CL2 file. Are you sure you don’t want to use WordPress instead of Drupal?
Sorry, I’m stuck in the Drupal universe for the moment.
Thanks for the info. I’ll post anything I come up with.
Mike:
I’m looking for a swim team management component and found yours. It looks really interesting so I want to see if I could arrange access to the site as a registered user. I notice you let a few folks in above. Can I arrange the same. Thanks.
Absolutely. Look for an e-mail from me shortly.
Mike:
I’ve installed wp-swimteam on my test site, and can’t seem to get anything to show up. on the back end, I don’t even have Settings>Swim Team as an option (although I do have a lovely Swim Team section). I can’t figure out how to get anything to show up on the front end. Help!
Maybe if I could register on the demo site, it might help me?
Thanks.
Sheila – if you are only seeing the “Swim Team” menu on the Dashboard it means your WordPress username doesn’t have sufficient permissions to see the “Manage”, “Reports”, or “Options” section OR you haven’t expanded the Swim Team menu on the Dashboard. There should be a small down arrow to the right side of the “Swim Team” menu which will expand the Swim Team menu section of the plugin. Only a WordPress Administrator can change the Swim Team Options and a Contributor or Editor can modify the items in the Manage menu. Check your e-mail for information on getting access to the Demo site.
Thanks, Mike! I was making a silly mistake, and I think I have a good bit of my previous (PEBCAC) issue sorted out. One final question I have is whether you can import information to the system… like last years list of swimmers and volunteer jobs to decrease data entry?
Right now there isn’t a mechanism to import any data although I have considered building the ability to import a roster as a CSV or SD3 file. If I did this, initially all swimmers would assigned to the Admin or Importing User as their Parent/Guardian. Jobs would be a lower priority but may be something I can look at in the future.
Hi Mike,
is the plugin able to generate the hy3 entry roster file that hy-tek meet manager expects to see to import entries for swimmers?
Hi,
I am feeling a bit dumb here, but….
How do I use the plugin? I can see it all in the dashboard, I can make all of the changes for settings, I just can’t figure out how to get to the “stuff”.
I guess I mean; How do I integrate the plugin into my site? Would I have a link that people would click on? A menu option? Do I use a theme?
Where I am at now is the two required plug-ins are installed, everything shows up in dashboard, but where does it show or how do integrate into the site/blog?
Thanks for any direction,
Jim
Hi. I am a bit of a loss. Starting with a brand new WordPress installation, with the 2010 theme, I install phpHtmlLib plugin and then the wp-SwimTeam plugin, and I am left with…a brand new WordPress installation with a 2010 theme.
The dashboard has the updates to change all sorts of settings for the newly installed plugin, but the site itself is unchanged.
I thought maybe I had to have the sandbox swim team theme installed, but that just changed the site to a text version of the 2010 theme.
I figure I must be doing something wrong, but I just can’t figure it out.
It does not seem like this should be hard to do, I must have something wrong somwhere.
Can anyone help?
Sorry for the delayed response, I was out in the mountains on vacation and not checking email.
The bulk of the interaction with the plugin for users and administrators is via the Dashboard. There is a new menu on the Dashboard called “Swim Team” that allows for various actions depending on the capabilities of the user. For example, a standard user or subscriber in the WordPress sense, is able to enter their contact data and register their swimmers, sign up for jobs, scratch their swimmers from swim meets, etc. An administrator has all of the user capabilities and much more including the ability to define a season and all of the swim meets that go with it, define the jobs that are required, and other administrative tasks.
On the front facing web site you can use a number of short codes within posts or pages to display information from the swim team as part of the outward facing web content. Most of the short codes are described on the Demo Site. Just looks through the posts to see examples.
I just responded to a similar comment a few minutes ago so please see that for some information on some of your questions.
You do not need the Sandbox Swim Team theme to use the plugin, they are independent efforts. I use the Swim Team theme on the MacDolphins site but the site would work just as well with any other theme.
Hope this helps, I am back online after vacation and can answer questions.
Hey Mike,
your plugin looks awesome and i was think if i could translate it into German? And maybe it would be possible to make some changes to use it for a running team.
I think there should be just a few changes to be done.
I really would love to help you with the translation and help changing to make it suitable for runners
Altough i get some strange errors via the backend. Here ist the error log:
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 92, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=9
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 1260, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=9
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 92, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=9
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 1260, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=1
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 92
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 92, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=4
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 1260
PHP Fatal error: Call to undefined method FEListBox::FEListBox() in /wp-content/plugins/phphtmllib/form/form_elements/FEListBox.inc on line 92, referer: http://DOMAIN/wp-admin/admin.php?page=swimteam_options_page&tab=6
On some Option Tabs i just get a blank screen.
Thanks a lot for your plugin anyway
Regarding the PHP error you are seeing, what version of PHP are you running?
As for using this plugin for runners, I assume you mean for managing a running or track and field team where you have runners in various heats for races of diffent distances – is that correct? If so, I think it would work based on my limited knowledge of track and field events. As for the German translation, I had originally started coding wp-SwimTeam with translation support but have gotten prettly lazy about making sure all of the strings are wrapped in the proper language translation functions. There would be a lot of strings to go back and re-visit but it wouldn’t be impossible.
Im using PHP Version 5.3.2-1ubuntu4.7
about the running them you were right…. The most part whould stay the same like male and femal age groups (maybe different size of groups im not that familiar with swimming^^) and instead of swim laps you would have a distance 10km= 10936Yards 5km=5468 Yards Marathon and Halfmarathon something like this.
I would have suspected that you had run into a PHP 5.3.x issue as i found a few of those when my swim team ISP moved to 5.3.3. I am running PHP 5.3.3 on IIS and haven’t seen this issue but I will go back and look at the code for FEListBox again in case I missed something.
Ok… i just done a php update to 5.3.5 and know everything works fine for me. I just recognized that the max age for a swimmer is 18
Would it maybe possible to raise the age to maybe 80?
That plugin really looks awesome… would love to have something like this for the running sports.
You can set the Max Age (which tops out at 125) under the Options->Swim Team section. You can set the minimum and maximum ages as fit your needs. Glad to hear upgrading PHP resolved the other problem because I couldn’t replicate it!
Can you send me info to sign up on the demo site? Thank you.
Check your e-mail for a username and password, let me know if you have any questions.
This sounds like a fantastic plug-in. Thank you so much for creating it. I am not able to complete my profile to start using the program. The to blank input fields under “City” which I’m sure are for “State” & “Zip” give me an error when I try to fill them in with the corresponding information. If I leave it blank, it gives me the error as well. I am using using WordPress 3.2.1. which might be the issue.
Tried using MS ASP.NET Club site template for our boy’s high school team site. Way to time intensive to maintain. May I have a login to explore your swim team plugin? It looks like it may have more functions than we need, but I assume I can disable and trim down to meet our needs. Thanks for all your efforts, it looks like you’ve put in massive amounts of time fine-tuning your plugin!
There is a minor configuration bug where the “State or Province” and “Postal Code” fields won’t work correctly until their labels are set correctly. You can do this by setting the field labels in the “Swim Team->Options” settings page. Once this is done, this error will go away.
Check your email for a login. There is a lot of functionality, much of which you don’t have to use if it doesn’t make sense for your application. Thanks for the support.
Can you email me a installation zip folder and some instructions?
Hi,
Just did a fresh install of your plugin with WordPress 3.3
After activating the plugin, I try to enter my info in the PROFILE tab and I can never save. It seems to be a problem with the State/ZIP fields.
† First Name:
† Last Name:
† E-Mail Address:
† Street 1:
Street 2:
Street 3:
† City:
† :
† :
† Country:
† Home Phone:
Mobile Phone:
† Contact Information:
Installation instructions are here. You can download the required phpHtmlLib plugin and the wp-SwimTeam plugin from the WordPress plugin repository. You can also use the standard WordPress “Add New Plugin” and search for either but you must install and activate phpHtmlLib before wp-SwimTeam or it won’t activate.
I thought I had written up this issue previously but it looks like I did it via e-mail – sorry about that. This is a known bug which is very simple to work around. The problem is the default settings for the “Postal Code” and “State or Province” settings aren’t set correctly and their setting drives the form field labels. To work around this, go to the Swim Team -> Options setting page and choose the “Swim Team” tab. At the bottom of the form are two fields, one for “State or Province” and one for “Postal Code”. Set them to the appropriate value for your geography (e.g. “State” and “Zip Code” for the United States). Once you’ve done this, the registration will work properly.
Hi Mike, can i get a link to the demo site at all please. Plugin Looks great!!!
A link or a login? The site is here: http://demo.wp-swimteam.org
Hi Mike.
Finally figured out the State / Postcode issue thanks to this page. Busy setting up various options, and I have a bug that keeps occurring on the test machine. My default IP address/URL is http://192.168.1.10:8080/, and when I use Re-Order events (which is quick – a great option), it doesn’t matter if I use Back or Home, it won’t save, and it may be because it is trying to append an additional :8080 to the IP address – http://192.168.1.10:8080:8080/wordpress/wp-admin/admin.php?page=swimteam_manage_page&tab=4
I suspect the :8080 suffix is indeed causing the problem. I am not sure if there is a quick fix for that bug. I’ll have to take a look at how the URL processing is accounting (or more likely not accounting for the suffix. I know I have never tested it that way.