Tool for cropping images at Wikimedia Commons and other Wikimedia wikis
PHP HTML JavaScript CSS Shell Python
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 25 commits behind danmichaelo:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
extras
logs
provision
public_html
src
tests
.codeclimate.yml
.description
.editorconfig
.gitignore
.lighttpd.conf
.travis.yml
Caddyfile
MIT-LICENSE.txt
README.md
Vagrantfile
bootstrap.php
check-server.py
check-server.sh
cleanup.sh
composer.json
config.dist.ini
crontab.tools
generate-key.php
gulpfile.js
package.json
phpunit.xml

README.md

CropTool

CropTool is a tool for cropping image files at Wikimedia Commons and other Wikimedia sites using the MediaWiki API with OAuth. Help page on Commons.

Setting up a development environment

The easiest way to setup a development environment is by using Vagrant. If you have Vagrant installed, just type

vagrant up

This will create a virtual machine with the static IP 172.28.128.4 (you can change this in the Vagrantfile if needed). To test the MediaWiki OAuth authentication, you can redirect tools.wmflabs.org to your newly created virtualbox machine by adding an entry to your /etc/hosts file:

172.28.128.4 tools.wmflabs.org

If you then visit https://tools.wmflabs.org/croptool in your browser, the content will be fetched from your virtualbox machine. The Vagrant provisioner has generated a self-signed certificate, so https will work, but the browser will of course warn you about the certificate being self-signed.

Of course you need to remember to remove the entry from /etc/hosts when you're done testing.

Setting up a lightweight development environment

As a lightweight alternative for a development environment, we provide a Caddyfile which is meant to be used with Caddy. This allows to do frontend development without the need to boot a virtual machine.

  1. Run caddy in the source directory
  2. Add 127.0.0.1 tools.wmflabs.org to your /etc/hosts
  3. Open https://tools.wmflabs.org:7890/croptool and accept the certificate warning (since we issue a self-signed certificate)

Deployment notes

To get jpegtran, we fetch the latest jpegsrc.xxx.tar.gz from the Independent JPEG Group. Note that the server returns "403 Forbidden" if you use the default curl user agent string.

curl -A "CropTool/0.1 (http://tools.wmflabs.org/croptool)" "http://www.ijg.org/files/jpegsrc.v9a.tar.gz" | tar -xz
cd jpeg-*
./configure
make
make test

Download deps and configure croptool:

  1. composer install --optimize-autoloader
  2. cp config.dist.ini config.ini and insert OAuth info and the path to jpegtran.
  3. Check that the server can write to logs and public_html/files.
  4. vendor/bin/phpunit
  5. crontab crontab.tools to setup cronjobs.
  6. npm install
  7. gulp build
  8. php generate-key.php