Drawtivity - installation guide

Installation of the Drawtivity system

The Drawtivity authoring system is available for download, adaptation and installation under a Creative Commons Attribution Share Alike license. This means Drawtivity can installed and used, adapted and shared so long as the website footer is displayed with attribution details for the original developers and funders of the project.

Minimum server requirements:

To install your own Drawtivity system you need to have access to a web server which runs:

  1. PHP version 5 or greater (which includes the zip and mysqli extensions)
  2. MySQL version 4.1.2 or greater

Instructions:

  1. Download and unzip the latest Drawtivity package.
  2. Create a database for Drawtivity on your web server, as well as a MySQL user who has all privileges for accessing and modifying it.
  3. Open dy_includes/dy_config.php in a text editor (such as Notepad) and amend the configuration settings as explained in editing dy_config.php.
  4. Place the Drawtivity files in the desired location on your web server (e.g. using FTP).
  5. Change the permissions on the dy_uploads and dy_downloads folders on your webserver so they allow the upload of files by site users (e.g. by setting folder access permissions to 775).
  6. Run the Drawtivity installation script by accessing the site index.php in a web browser.
  7. Follow the instructions to create an admin user.

That's it! Drawtivity should now be installed.

If you encounter problems with your installation please contact us for assistance.

Editing dy_config.php

You should only edit the dy_config.php file using an appropriate text editor (e.g. Notepad) or coding software (e.g. Dreamweaver).

There are a set of six settings at the top of the dy_config.php file that you will need to amend before installing the Drawtivity site.

  1. // The name of the database
    define('DB_NAME', 'name of your database');
  2. // MySQL database username
    define('DB_USER', 'your database users username');
  3. // MySQL database password
    define('DB_PASSWORD', 'your database users password');
  4. //a random string added to user passwords when encrypted in the database (replace this with your own long random string - use a random string generating service such as http://www.random.org/strings/)
    define("SITE_SALT", 'a long random string of characters');
  5. //url of the site
    define("SITE_URL", 'the url of the website including http://');
  6. //the FROM email address used by the system when sending automated emails
    define("SITE_CONTACT_EMAIL", 'your email address');

Optional dy_config.php settings

The remaining settings in the dy_config.php file are optional and can be left with their default values:

  1. //format used for dates displayed on the site (google "PHP date" for more information)
    define("DATE_FORMAT", 'jS M Y');
  2. //format used for date and times displayed on the site (again google "PHP date" for more information)
    define("DATE_TIME_FORMAT", DATE_FORMAT.' g.ia');
  3. //long name for the site used as the alt text for the site header logo
    define("SITE_NAME_LONG", 'Drawtivity - OER drawing activities for learning');
  4. //shorter name for the site used in the site content
    define("SITE_NAME_SHORT", 'Drawtivity');
  5. //location of uploaded activity files
    define("UPLOAD_LOCATION", 'dy_uploads/');
  6. //upload limit in KB
    define("UPLOAD_FILESIZE_LIMIT", 400);
  7. //number of activities displayed per page of search results
    define("NUM_SEARCH_RESULTS", 10);
  8. //user id that is the site administrator - default = 1
    define("ADMIN_USER_ID", 1);
  9. //limit registrations to email domains, separate email extensions with commas e.g. '@hotmail.com, @hotmail.co.uk, @gmail.com'
    define("ACCEPTED_EMAIL_EXTENSIONS", '');
  10. //whether to display activities on the activity pages
    define("DISPLAY_ACTIVITIES", true);
  11. //HTML tags allowed in site error messages
    define("SOME_TAGS",'<strong><em><br><p><a><ul><ol><li>');