PHP 클래스 Give_API, Give

Renders API returns as a JSON/XML array
부터: 1.1
파일 보기 프로젝트 열기: wordimpress/give 1 사용 예제들

공개 프로퍼티들

프로퍼티 타입 설명
$log_requests boolean Log API requests?
$override boolean
$user_id integer User ID Performing the API Request

보호된 프로퍼티들

프로퍼티 타입 설명
$versions string All versions of the API

공개 메소드들

메소드 설명
__construct ( ) Setup the Give API
add_endpoint ( array $rewrite_rules ) Registers a new rewrite endpoint for accessing the API
api_key_backwards_compat ( string $check, integer $object_id, string $meta_key, boolean $single ) : string API Key Backwards Compatibility
generate_api_key ( integer $user_id, boolean $regenerate = false ) : boolean Generate new API keys for a user
get_customers ( integer $customer = null ) : array Process Get Customers API Request
get_dates ( array $args = [] ) : array Sets up the dates used to retrieve earnings/donations
get_default_version ( ) : string Retrieves the default version of the API to use
get_forms ( integer $form = null ) : array Process Get Donation Forms API Request
get_output ( ) : array Retrieve the output data
get_output_format ( ) : mixed | void Retrieve the output format
get_paged ( ) : integer Get page number
get_queried_version ( ) : string Retrieve the API version that was queried
get_query_mode ( ) : string Returns the API endpoint requested
get_recent_donations ( ) : array Retrieves Recent Donations
get_stats ( array $args = [] ) : array Process Get Stats API Request
get_token ( integer $user_id ) : string Retrieve the user's token
get_user ( string $key = '' ) : boolean Retrieve the user ID based on the public key provided
get_user_public_key ( $user_id )
get_user_secret_key ( $user_id )
get_version ( )
get_versions ( ) : array Retrieve the API versions
output ( integer $status_code = 200 ) Output Query in either JSON/XML. The query data is outputted as JSON by default
per_page ( ) : integer Number of results to display per page
process_api_key ( array $args ) : void Process an API key generation/revocation
process_query ( ) : void Listens for the API and then processes the API requests
query_vars ( array $vars ) : string[] Registers query vars for API access
revoke_api_key ( integer $user_id ) : string Revoke a users API keys
set_query_mode ( ) Determines the kind of query requested and also ensure it is a valid query
update_key ( integer $user_id ) : void Generate and Save API key
user_key_field ( object $user ) : void Modify User Profile

비공개 메소드들

메소드 설명
generate_private_key ( integer $user_id ) : string Generate the secret key for a user
generate_public_key ( string $user_email = '' ) : string Generate the public key for a user
get_default_earnings_stats ( ) : array Generate the default earnings stats returned by the 'stats' endpoint
get_default_sales_stats ( ) : array Generate the default sales stats returned by the 'stats' endpoint
get_form_data ( object $form_info ) : array Given a give_forms post object, generate the data for the API output
invalid_auth ( ) : void Displays an authentication failed error if the user failed to provide valid credentials
invalid_key ( ) : void Displays an invalid API key error if the API key provided couldn't be validated
invalid_version ( ) : void Displays an invalid version error if the version number passed isn't valid
log_request ( array $data = [] ) : void Log each API request, if enabled
missing_auth ( ) Displays a missing authentication error if all the parameters aren't provided
set_queried_version ( ) Sets the version of the API that was queried.
validate_request ( ) : void Validate the API request

메소드 상세

__construct() 공개 메소드

Setup the Give API
부터: 1.1
public __construct ( )

add_endpoint() 공개 메소드

Registers a new rewrite endpoint for accessing the API
부터: 1.1
public add_endpoint ( array $rewrite_rules )
$rewrite_rules array WordPress Rewrite Rules

api_key_backwards_compat() 공개 메소드

A Backwards Compatibility call for the change of meta_key/value for users API Keys
부터: 1.3.6
public api_key_backwards_compat ( string $check, integer $object_id, string $meta_key, boolean $single ) : string
$check string Whether to check the cache or not
$object_id integer The User ID being passed
$meta_key string The user meta key
$single boolean If it should return a single value or array
리턴 string The API key/secret for the user supplied

generate_api_key() 공개 메소드

Generate new API keys for a user
부터: 1.1
public generate_api_key ( integer $user_id, boolean $regenerate = false ) : boolean
$user_id integer User ID the key is being generated for
$regenerate boolean Regenerate the key for the user
리턴 boolean True if (re)generated succesfully, false otherwise.

get_customers() 공개 메소드

Process Get Customers API Request
부터: 1.1
public get_customers ( integer $customer = null ) : array
$customer integer Customer ID
리턴 array $customers Multidimensional array of the customers

get_dates() 공개 메소드

Sets up the dates used to retrieve earnings/donations
부터: 1.2
public get_dates ( array $args = [] ) : array
$args array Arguments to override defaults
리턴 array $dates

get_default_version() 공개 메소드

Retrieves the default version of the API to use
부터: 1.1
public get_default_version ( ) : string
리턴 string

get_forms() 공개 메소드

Process Get Donation Forms API Request
부터: 1.1
public get_forms ( integer $form = null ) : array
$form integer Give Form ID
리턴 array $customers Multidimensional array of the forms

get_output() 공개 메소드

Retrieve the output data
부터: 1.1
public get_output ( ) : array
리턴 array

get_output_format() 공개 메소드

Determines whether results should be displayed in XML or JSON
부터: 1.1
public get_output_format ( ) : mixed | void
리턴 mixed | void

get_paged() 공개 메소드

Get page number
부터: 1.1
public get_paged ( ) : integer
리턴 integer $wp_query->query_vars['page'] if page number returned (default: 1)

get_queried_version() 공개 메소드

Retrieve the API version that was queried
부터: 1.1
public get_queried_version ( ) : string
리턴 string

get_query_mode() 공개 메소드

Returns the API endpoint requested
부터: 1.1
public get_query_mode ( ) : string
리턴 string $query Query mode

get_recent_donations() 공개 메소드

Retrieves Recent Donations
부터: 1.1
public get_recent_donations ( ) : array
리턴 array

get_stats() 공개 메소드

Process Get Stats API Request
부터: 1.1
public get_stats ( array $args = [] ) : array
$args array Arguments provided by API Request
리턴 array

get_token() 공개 메소드

Retrieve the user's token
부터: 1.1
public get_token ( integer $user_id ) : string
$user_id integer
리턴 string

get_user() 공개 메소드

Retrieve the user ID based on the public key provided
부터: 1.1
public get_user ( string $key = '' ) : boolean
$key string Public Key
리턴 boolean if user ID is found, false otherwise

get_user_public_key() 공개 메소드

public get_user_public_key ( $user_id )

get_user_secret_key() 공개 메소드

public get_user_secret_key ( $user_id )

get_version() 공개 메소드

public get_version ( )

get_versions() 공개 메소드

Retrieve the API versions
부터: 1.1
public get_versions ( ) : array
리턴 array

output() 공개 메소드

Output Query in either JSON/XML. The query data is outputted as JSON by default
부터: 1.1
public output ( integer $status_code = 200 )
$status_code integer

per_page() 공개 메소드

Number of results to display per page
부터: 1.1
public per_page ( ) : integer
리턴 integer $per_page Results to display per page (default: 10)

process_api_key() 공개 메소드

Process an API key generation/revocation
부터: 1.1
public process_api_key ( array $args ) : void
$args array
리턴 void

process_query() 공개 메소드

Listens for the API and then processes the API requests
부터: 1.1
public process_query ( ) : void
리턴 void

query_vars() 공개 메소드

Registers query vars for API access
부터: 1.1
public query_vars ( array $vars ) : string[]
$vars array Query vars
리턴 string[] $vars New query vars

revoke_api_key() 공개 메소드

Revoke a users API keys
부터: 1.1
public revoke_api_key ( integer $user_id ) : string
$user_id integer User ID of user to revoke key for
리턴 string

set_query_mode() 공개 메소드

Determines the kind of query requested and also ensure it is a valid query
부터: 1.1
public set_query_mode ( )

update_key() 공개 메소드

Generates the key requested by user_key_field and stores it in the database
부터: 1.1
public update_key ( integer $user_id ) : void
$user_id integer
리턴 void

user_key_field() 공개 메소드

Modifies the output of profile.php to add key generation/revocation
부터: 1.1
public user_key_field ( object $user ) : void
$user object Current user info
리턴 void

프로퍼티 상세

$log_requests 공개적으로 프로퍼티

Log API requests?
부터: 1.1
public bool $log_requests
리턴 boolean

$override 공개적으로 프로퍼티

부터: 1.1
public bool $override
리턴 boolean

$user_id 공개적으로 프로퍼티

User ID Performing the API Request
부터: 1.1
public int $user_id
리턴 integer

$versions 보호되어 있는 프로퍼티

All versions of the API
부터: 1.1
protected string $versions
리턴 string