From 851c4afb5816a2fe3f4975ebd8f04735ed7755d3 Mon Sep 17 00:00:00 2001
From: Victor Jonsson
Date: Sat, 2 Feb 2019 08:48:03 +0100
Subject: [PATCH 1/4] Update README.md
---
README.md | 244 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 241 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
index e02a533..d3002ae 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
-# jQuery Form Validator
+# jQuery Form Validator [DISCONTINUED]
*Validation framework that let's you configure, rather than code, your validation logic.*
I started writing this plugin back in 2009 and it has given me much joy over the years. But all good things must come to an end and now it's time for this plugin to pull in its oars and go down with history.
-**NOTICE!** This plugin is no longer being developed! It supports jQuery v. 1.8 >= 2.2.4. No pull requests will become merged in but feel free to fork and do whatever you like!
+**This plugin is no longer being developed!** It supports jQuery v. 1.8 >= 2.2.4. No pull requests will become merged in but feel free to fork and do whatever you like!
[](https://travis-ci.org/victorjonsson/jQuery-Form-Validator/builds/)
@@ -82,7 +82,7 @@ Read the documentation for the default features at [#default-validators](#defaul
* **letternumeric** — *Validate that the input value consists out of only letters and/or numbers*
* **recaptcha** - *Validate Google [reCaptcha 2](https://www.google.com/recaptcha/intro/index.html)*
-Read the documentation for the security module at [http://formvalidator.net/#security-validators](http://formvalidator.net/#security-validators)
+Read the documentation for the security module at [#security-validators](#security-validators)
### Module: date
* **time** — *hh:mm*
@@ -487,6 +487,244 @@ You can tell any validator to ignore certain characters by using the attribute d
```
+## Security validators<
+
+### Password confirmation
+
+This validator can be used to validate that the values of two inputs are the same. The first input should have a name suffixed with _confirmation and the second should have the same name but without the suffix.
+
+```
+
+```
+
+### Password strength
+
+Use this validator to make sure that your user has a strong enough password. Set attribute data-validation-strength to 1, 2 or 3 depending on how strong password you require.
+
+If you want the strength of the password to be displayed while the user types you call displayPasswordStrength() in the end of the form.
+
+```
+
+
+
+
+
+```
+
+### Server side validation
+
+By using this validator you can validate the value given by the user on the server before the form gets submitted. The validation function will send a POST request to the URL declared in data-validation-url. The argument posted to the URL will have the same name as the input being validated.
+
+The form will get the class validating-server-side while the server is being requested.
+
+The response from the validation script must be a JSON formatted object, containing the properties "valid" and "message".
+
+```
+{
+ "valid" : true|false,
+ "message" : "String with text that should be displayed as error message"
+}
+```
+
+#### Form
+
+```
+
+```
+
+#### /validate-input.php
+
+```
+ false,
+ 'message' => 'Post argument "user" is missing.'
+);
+
+if( isset($_POST['user']) ) {
+ $userRepo = new UserRepository( DataStorage::instance() );
+ $user = $userRepo->loadUser( $_POST['user'] );
+
+ if( $user ) {
+ // User name is registered on another account
+ $response = array('valid' => false, 'message' => 'This user name is already registered.');
+ } else {
+ // User name is available
+ $response = array('valid' => true);
+ }
+}
+echo json_encode($response);
+```
+
+**Modifying the server request**
+
+The parameter containing the input value, sent to the server, will by default have the same name as the input. You can however set your own parameter name by using the attribute data-validation-param-name. You can also send along other parameters to the server by using the attribute data-validation-req-params.
+
+```
+$user->get('ID')));
+?>
+
+ E-mail:
+
+
+```
+
+### Credit card validation
+
+This validator makes it possible to validate any of the credit cards VISA, Mastercard, Diners club, Maestro, CJB, Discover and American express
+
+```
+<-- Accept credit card number from Visa, Mastercard and American Express -->
+
+ Credit card number
+
+
+
+ Security code (cvv)
+
+
+```
+
+You can also let the user choose a credit card and programmatically change the allowed credit card on the input of the card number.
+
+```
+
+ Credit card
+
+
+
+ Credit card number
+
+
+...
+
+
+```
+
+### Simple captcha
+
+```
+
+
+```
+
+### Google reCAPTCHA
+
+Use this validator if wanting to integrate the Google service reCAPTCHA.
+
+```
+