class-wc-object-data-store-interface.php 1.44 KB
Newer Older
imac's avatar
imac committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * WC Data Store Interface
 *
 * @version  3.0.0
 * @category Interface
 * @author   WooThemes
 */
interface WC_Object_Data_Store_Interface {
	/**
	 * Method to create a new record of a WC_Data based object.
	 * @param WC_Data &$data
	 */
	public function create( &$data );

	/**
	 * Method to read a record. Creates a new WC_Data based object.
	 * @param WC_Data &$data
	 */
	public function read( &$data );

	/**
	 * Updates a record in the database.
	 * @param WC_Data &$data
	 */
	public function update( &$data );

	/**
	 * Deletes a record from the database.
	 * @param  WC_Data &$data
	 * @param  array $args Array of args to pass to the delete method.
	 * @return bool result
	 */
	public function delete( &$data, $args = array() );

	/**
	 * Returns an array of meta for an object.
	 * @param  WC_Data &$data
	 * @return array
	 */
	public function read_meta( &$data );

	/**
	 * Deletes meta based on meta ID.
	 * @param  WC_Data &$data
	 * @param  object $meta (containing at least ->id)
	 * @return array
	 */
	public function delete_meta( &$data, $meta );

	/**
	 * Add new piece of meta.
	 * @param  WC_Data &$data
	 * @param  object $meta (containing ->key and ->value)
	 * @return int meta ID
	 */
	public function add_meta( &$data, $meta );

	/**
	 * Update meta.
	 * @param  WC_Data &$data
	 * @param  object $meta (containing ->id, ->key and ->value)
	 */
	public function update_meta( &$data, $meta );
}