== pdf2submission plugin version 2 ==

pdf2submission is a plugin to automatically accept hand-written or hand-drawn documents (scanned image PDF) as Moodle assignment submissions (There is no need for each learner to upload the file to Moodle).

Please note that this versin of pdf2submission works only for Assignment2.3 (not for previous type of Assignment).

This package includes FPDI and TCPDF in the subdirectories. See the license description in each subdirectory. Except these subdirectories, pdf2submission is licensed under GPL v3 or later.
http://www.gnu.org/copyleft/gpl.html


How to install:

Basically, pdf2submission plugin is intended to run on Linux servers (some external commands are used in processing PDF files).

1) Install required external commands if they are not yet available on your Moodle server.

The required external commands are pdftk, ImageMagick convert, ghostscript, zbarimg.

On CentOS 6, the following yum command will install all except zbarimg command:
# yum install pdftk ImageMagick ImageMagick-devel ghostscript

For zbarimg command, get the source code from http://sourceforge.net/projects/zbar/ and make install like:
wget http://sourceforge.net/projects/zbar/files/zbar/0.10/zbar-0.10.tar.bz2/download
bunzip2 zbar-0.10.tar.bz2
tar xvf zbar-0.10.tar
./configure --with-x=no --enable-video=no --with-python=no --with-gtk=no --with-qt=no
make
make install

2) unzip pdf2submission.zip and move pdf2submission folder into Moodle blocks/ folder, and as admin click 'Site administration - Notifications' to let Moodle install pdf2submission block (like a typical block installation).

3) 'inputfolder' specified in pdfscan.php (where scanned image PDF files are put) must be writable by pdf2submission cron job, so you need to set write permission by a command like 'chgrp apache /home/pdf2moodle/pdfs; chmod g+w /home/pdf2moodle/pdfs'.


KITA Toshihiro
http://tkita.net/