Download the PHP package elioair/chesscaptcha without Composer
On this page you can find all versions of the php package elioair/chesscaptcha. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elioair/chesscaptcha
More information about elioair/chesscaptcha
Files in elioair/chesscaptcha
Package chesscaptcha
Short Description A simple chess based captcha system.
License MIT
Homepage http://elioair.github.io/chesscaptcha/
Informations about the package chesscaptcha
Chess Captcha
Requirements: php >= 5.4, jquery > 1.8 | Latest Version 2.0.2
This is a captcha system where the user either recreates the position of the pieces on the board - non chess savvy users - or she solves a mate-in-one puzzle by putting the piece on the square where it gives the checkmate - chess savvy users only. There is also a no js fallback that exists mostly as a placeholder for future iterations; don't use it. Chesscaptcha was built for fun, it is a work in progress so feel free to make pull requests and contribute!
View demo here.
:books: Laravel + Chesscaptcha Tutorial here.
:books: Chess captcha + Emojis here.
Created by @elioair | twitter: @elioair
Libraries used:
Implementation:
Through Composer
After composer finishes importing the package:
- You may remove the
/vendor/elioair/chesscaptcha/examples
directory - Place the
/vendor/elioair/chesscaptcha/assets
directory or it's contents where it suits your project. Note that the image files are used both by thejs
client and thephp
server side. - Fix the image paths in the
/vendor/elioair/chesscaptcha/src/ChessCaptcha/BoardImageCreator.php
Directly cloning the repo
Clone the repository and see immediately how it works by going to the /examples
folder. You might need to require_once
the files of the classes involved in the class files in the src/ChessCaptcha
folder.
Quick tip: run composer install
and then composer dump-autoload --optimize
and include the loader.
Working Example: /examples/chesscaptcha-example.php
The php configuration
The HTML
The javascript + js options object
Add this at the end and configure it if you want ajax validation
Validation
Grab the chesscaptchaposition
from the POST request and feed it into the validation method. $validate = \ChessCaptcha\ChessCaptcha::validate($inputFen, $noJs, $colorTolerance);
see the src/chesscaptchavalidate.php
file for more.
Further Configuration:
Look into the boardimagecreator.php
for settings on the image.
Issues
-
The position when set to Start from the button is not updated on purpose. Avoid having an initial position as a fen string in the fen array.
- On some tablets, when zoomed-in the pieces are not placed correctly.
TODO
- Add support for more than one instances per page.
FAQ
1. How do I change the positions displayed?
Edit the array $givenFen
in src/fengenerator.php
for the simple mode and the $givenMateInOne
for the mate mode.
2. Pieces are not showing up or no board image is shown.
Make sure that you have the paths to the image files of the pieces right. E.g. $pieceImageDir
property in boardimagecreator.php
and $config['$pieceImageDir']
.
3. How do I make the check ignore the piece color?
Pass true
as the third argument of the Chesscaptcha::validate
method to make the comparison color agnostic.
License
Distributed under the MIT license