Contribute

This page contains instructions on how to set up a development version of AN_GradeBook. The instructions assume you are using Mac OS X (Yosemite).

  • We will need to install mySQL, php, Apache, WordPress, and an-gradebook.
  • First, set up mySQL, php, and Apache. Jason McCreary has an excellent post on how, here.
  • Second, install WordPress. Navigate to a folder where you would like to set up your dev site, preferably somewhere in your home path (cd ~/). We will use ~/Desktop/Dev. Navigate to this directory (cd ~/Desktop/Dev), get the latest version of WordPress (wget http://wordpress.org/latest.tar.gz), and unpack it (tar -xzvf latest.tar.gz). You should now have a WordPress subdirectory (ls -l). Link this folder to /Library/WebServer/Documents (ln -s ~/Desktop/Dev/WordPress /Library/WebServer/Documents).

    Create a MySQL admin user and a MySQL database for WordPress.

    $ mysql -u root -p
    Enter password:
    Welcome to the MySQL monitor. Commands end with ; or \g.
    Your MySQL connection id is 5340 to server version: 3.23.54

    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

    mysql> CREATE DATABASE wordpress;
    Query OK, 1 row affected (0.00 sec)

    mysql> GRANT ALL PRIVILEGES ON wordpress.* TO "admin"@"localhost"
    -> IDENTIFIED BY "password";
    Query OK, 0 rows affected (0.00 sec)

    mysql> FLUSH PRIVILEGES;
    Query OK, 0 rows affected (0.01 sec)

    mysql> EXIT
    Bye
    $

  • To complete the set-up process, navigate and complete the form at http://localhost/WordPress/wp-config.php
  • Lastly, install AN_GradeBook. Create a Github account at github.com. Fork the an-gradebook repo at https://github.com/aorinevo/an-gradebook. Navigate to the plugins directory of WordPress (cd ~/Desktop/Repositories/Dev/WordPress/wp-content/plugins). Clone an-gradebook (git clone https://github.com/aorinevo/an-gradebook.git). You should now have an-gradebook as a subdirectory (ls -l).
  • Activate the AN_GradeBook plugin in WordPress. In your browser, navigate to http://localhost/WordPress/wp-admin/plugins.php and click on the activation link for AN_GradeBook.