woocommerce/includes/interfaces/class-wc-payment-token-data...

67 lines
1.7 KiB
PHP
Raw Normal View History

2016-11-14 14:20:41 +00:00
<?php
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* WC Payment Token Data Store Interface
*
* Functions that must be defined by payment token store classes.
*
2017-03-15 16:36:53 +00:00
* @version 3.0.0
2016-11-14 14:20:41 +00:00
* @category Interface
* @author WooThemes
*/
2016-11-14 17:13:55 +00:00
interface WC_Payment_Token_Data_Store_Interface {
2016-11-14 14:20:41 +00:00
/**
* Returns an array of objects (stdObject) matching specific token criteria.
2016-11-14 14:20:41 +00:00
* Accepts token_id, user_id, gateway_id, and type.
* Each object should contain the fields token_id, gateway_id, token, user_id, type, is_default.
* @param array $args
* @return array
*/
public function get_tokens( $args );
/**
* Returns an stdObject of a token for a user's default token.
* Should contain the fields token_id, gateway_id, token, user_id, type, is_default.
* @param int $user_id
2016-11-14 14:20:41 +00:00
* @return object
*/
public function get_users_default_token( $user_id );
/**
* Returns an stdObject of a token.
* Should contain the fields token_id, gateway_id, token, user_id, type, is_default.
* @param int $token_id
2016-11-14 14:20:41 +00:00
* @return object
*/
public function get_token_by_id( $token_id );
/**
* Returns metadata for a specific payment token.
* @param int $token_id
2016-11-14 14:20:41 +00:00
* @return array
*/
public function get_metadata( $token_id );
/**
* Get a token's type by ID.
*
2017-03-15 16:36:53 +00:00
* @since 3.0.0
* @param int $token_id
2016-11-14 14:20:41 +00:00
* @return string
*/
public function get_token_type_by_id( $token_id );
/**
* Update's a tokens default status in the database. Used for quickly
* looping through tokens and setting their statuses instead of creating a bunch
* of objects.
* @param int $token_id
* @param bool $status
2016-11-14 14:20:41 +00:00
* @return string
*/
public function set_default_status( $token_id, $status = true );
}