Kohana User Guide

libraries:validation

avantar — Wed, 03 Sep 2008 07:19:42 -0500

1219601429		current
Line 39:		Line 39:
	<code php>		<code php>
	$_POST->add_rules('email', 'required', array('valid','email'));		$_POST->add_rules('email', 'required', array('valid','email'));
-	$_POST->add_rules('email' 'required', 'valid::email');	+	$_POST->add_rules('email', 'required', 'valid::email');
	$_POST->add_rules('email', 'required', 'email');		$_POST->add_rules('email', 'required', 'email');
	</code>		</code>

changelog:2.2 - better organization

shadowhand — Mon, 01 Sep 2008 11:01:28 -0500

1220284888		current
Line 10:		Line 10:
	New		New

-	* Captcha : Generates and validates [[wp->Captcha\|captcha]] images	+	* Captcha : Generates and validates [[wp>Captcha\|captcha]] images
	* Database : Added Mssql driver		* Database : Added Mssql driver
	* Payment : Added Paypal Pro driver		* Payment : Added Paypal Pro driver

userguide:todo

spirit — Fri, 29 Aug 2008 06:35:07 -0500

1220003967		current
Line 57:		Line 57:

	Helpers		Helpers
-	* [[helpers:arr\|Array]] document the <del>''range''</del> ''merge'' <del>''overwrite''</del> ''map_recursive'' <del>''unshift_assoc''</del> methods	+	* [[helpers:arr\|Array]] <del>document the ''range'' ''merge'' ''overwrite'' ''map_recursive'' ''unshift_assoc'' methods</del>
	* [[helpers:cookie\|Cookie]] <del>remove reference to ''prefix'' (spirit)</del>		* [[helpers:cookie\|Cookie]] <del>remove reference to ''prefix'' (spirit)</del>
	* [[helpers:html\|HTML]] <del>remove reference to ''query_string'' document additional methods (spirit)</del>		* [[helpers:html\|HTML]] <del>remove reference to ''query_string'' document additional methods (spirit)</del>

helpers:arr

spirit — Fri, 29 Aug 2008 06:33:46 -0500

1220009596		current
Line 237:		Line 237:

	* [array] any number of arrays		* [array] any number of arrays
		+	* returns [array] the merged array

	Example:		Example:

helpers:remote - Updated remote helper doc

spirit — Fri, 29 Aug 2008 04:55:53 -0500

1219839704		current
Line 3:		Line 3:

	====== Remote Helper ======		====== Remote Helper ======
		+
		+	A helper designed to retrieve remote url and file status.
		+
		+	===== Methods =====
		+
		+	==== Status ====
		+
		+	''status($url)'' returns the [[http://en.wikipedia.org/wiki/List_of_HTTP_status_codes\|HTTP status code]] of the given URL. It takes:
		+
		+	* [string] ''$url'' the address you want to get the status of
		+	* returns [string\|bool] the status code if it exists or FALSE
		+
		+	Example
		+
		+	<code php>
		+	echo remote::status('http://www.kohanaphp.com');
		+	echo remote::status('http://trac.kohanaphp.com');
		+	echo remote::status('http://dev.kohanaphp.com');
		+	echo remote::status('http://www.kohanaphp.com/idontexist');
		+	</code>
		+
		+	It will result in:
		+
		+	<code html>
		+	302 // Found
		+	301 // Moved Permanently
		+	200 // OK
		+	404 // File Not Found
		+	</code>

addons:payment - Convert the doc from lib to module (mainly loading)

spirit — Wed, 27 Aug 2008 08:23:18 -0500

1218499536		current
Line 6:		Line 6:
	===== Overview =====		===== Overview =====

-	The payment library allows you to easily process e-commerce transactions without having to worry about all the backend details of connecting and setting up the cURL options. It has many features:	+	The payment module allows you to easily process e-commerce transactions without having to worry about all the backend details of connecting and setting up the cURL options. It has many features:

	- An extremely easy API (only one method required to process a transaction!)		- An extremely easy API (only one method required to process a transaction!)
Line 13:		Line 13:
	- Support for credit card gateways as well as PayPal-like gateways		- Support for credit card gateways as well as PayPal-like gateways

-	Using the library is very simple. Just set the fields required by your driver, and process().	+	===== Loading the payment module =====
		+
		+	This can be done in the application/config/config.php file using the 'modules' setting.
		+
		+	<code php>$config['modules'] => array
		+	(
		+	'modules/auth',
		+	'modules/payment'
		+	)
		+	</code>
		+
		+	Then you just have to instantiate the module to use it. For example:
		+
		+	<code php>
		+	$payment = new Payment();
		+	</code>
		+
		+	===== Usage example =====
		+
		+	Using it is very simple. The code below shows how to use the payment module, just set the fields required by your driver, and process().

	<code php>		<code php>
Line 32:		Line 51:
	===== Configuration =====		===== Configuration =====

-	In system/config/payment.php there is a sample config for each payment gateway we support. Simply copy this file to your application directory, and remove the drivers you are not using. The library can support using more than one driver per application by passing the driver name to the constructor:	+	In system/config/payment.php there is a sample config for each payment gateway we support. Simply copy this file to your application directory, and remove the drivers you are not using. The module can support using more than one driver per application by passing the driver name to the constructor:

	<code php>		<code php>
Line 45:		Line 64:
	===== Attributes =====		===== Attributes =====

-	The payment library has a set of default attributes it uses to send payments to the gateway. These attributes are fairly self explanatory and are listed below.	+	The payment module has a set of default attributes it uses to send payments to the gateway. These attributes are fairly self explanatory and are listed below.

	* card_num		* card_num
Line 76:		Line 95:
	===== Methods =====		===== Methods =====

-	The payment library has a minimal set of methods to use:	+	The payment module has a minimal set of methods to use:

	==== set_fields() ====		==== set_fields() ====
Line 100:		Line 119:
	===== Drivers =====		===== Drivers =====

-	The payment library uses drivers much like the Database library does in order to keep the API consistent between payment gateways. It currently supports the following gateways:	+	The payment module uses drivers much like the Database library does in order to keep the API consistent between payment gateways. It currently supports the following gateways:

	- Authorize.net		- Authorize.net
Line 205:		Line 224:
	===== Writing Your Own Driver =====		===== Writing Your Own Driver =====

-	There are many more payment gateways than there are drivers provided by Kohana. We encourage you to write your own when you encounter a gateway not supported by the library. An easy way to do it is like so:	+	There are many more payment gateways than there are drivers provided by Kohana. We encourage you to write your own when you encounter a gateway not supported by the module. An easy way to do it is like so:

	- Add a new entry in config/payment.php with your driver details. Use the previous entries as an example.		- Add a new entry in config/payment.php with your driver details. Use the previous entries as an example.

addons:archive

spirit — Wed, 27 Aug 2008 08:17:00 -0500

1219839425		current
Line 10:		Line 10:
	Currently it supports Zip, GZip, BZip and Tar Archives.		Currently it supports Zip, GZip, BZip and Tar Archives.

-	===== Loading the archive library =====	+	===== Loading the archive module =====
	This can be done in the application/config/config.php file using the 'modules' setting.		This can be done in the application/config/config.php file using the 'modules' setting.

general:loading - replace session loading example with cache (because a couple of lines below ...

spirit — Wed, 27 Aug 2008 08:10:46 -0500

1218638624		current
Line 22:		Line 22:
	Libraries can be loaded using PHP5's nifty auto_load function:		Libraries can be loaded using PHP5's nifty auto_load function:
	<code php>		<code php>
-	$this->session = new Session;	+	$this->cache= new Cache;
-	echo $this->session->id();	+	echo $this->cache->get('mycache');
	</code>		</code>

1220003967		current
Line 57:		Line 57:

	Helpers		Helpers
-	* [[helpers:arr\|Array]] document the <del>''range''</del> ''merge'' <del>''overwrite''</del> ''map_recursive'' <del>''unshift_assoc''</del> methods	+	* [[helpers:arr\|Array]] <del>document the ''range'' ''merge'' ''overwrite'' ''map_recursive'' ''unshift_assoc'' methods</del>
	* [[helpers:cookie\|Cookie]] <del>remove reference to ''prefix'' (spirit)</del>		* [[helpers:cookie\|Cookie]] <del>remove reference to ''prefix'' (spirit)</del>
	* [[helpers:html\|HTML]] <del>remove reference to ''query_string'' document additional methods (spirit)</del>		* [[helpers:html\|HTML]] <del>remove reference to ''query_string'' document additional methods (spirit)</del>

1220009596		current
Line 237:		Line 237:

	* [array] any number of arrays		* [array] any number of arrays
		+	* returns [array] the merged array

	Example:		Example: