Fully automated tool to promote invitation to next Toastmasters meeting.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css
fonts
images
js
src
.gitignore
.htaccess
README.md
composer.json
example.json
generate.php

README.md

Toastmasters Meeting Invitation

Toastmasters Meeting Invitation is simple automated tool written in php intended to be used by Toastmasters club. This app can help you to present invitation to your next meeting without EasySpeak. You only need to edit one file to get it running.

What does it do?

It generates one-page website with simple responsive design (real-world example can be seen on my club's website. This page contains:

  • TM logo
  • next meeting information (when, where, link to EasySpeak and Tostmaster's name)
  • personal invitation
  • 3 images of your choice
  • links to social networks

It aims to provide simple way for everyone to invite someone to club meeting without sending any e-mails or links to Easyspeak.

How does it work?

When generate.php file is triggered, JSON datafile containing information about next meeting is downloaded, processed, then combined with some local data about your club. After that, everything is put into template and index.html is generated. That's all. Now everything is ready and you just need to bring visitors to your new site.

Wait, what JSON datafile???

Yep, this can be a little problem. To get this site working, you need a json file (specific format needed) which contains information about meeting. If you have a club website and you release invitations to every meeting, just tell your webmaster to create JSON output with this specific format. If you don't have any website, either create one or try to contact me, and see if I can help you somehow.

JSON file format

If your json file contains data about more than one meeting, the actual meeting must be on the top of json file. Please see example.json to see required naming conventions.

Installation

  1. Clone this repository (branch master) and run 'composer install'.
  2. Copy src/config.php-example to src/config.php
  3. Edit src/config.php file
  • $feed_url - URL to JSON file
  • $meeting['ga_code'] - Google Analytics code (like UA-xxxxxxxx-y)
  • Everything under 'Club specific information' is text to be shown (HTML allowed) on the website. Example text is present for easier understanding.
  1. Run generate.php

Personal note

I wanted to test Plates templating system so I wrote a simple site for my club. Then I decided to make the code open, so everyone can use it almost without any knowledge of programming (you only need to edit one file). The base code was written in few minutes, so it is not actually very nice, but it just works :)

License

Theme based on html5up.net template. If you want to say thanks, leave a link to my club's website in footer.