PHP Класс Give_API, Give

Renders API returns as a JSON/XML array
С версии: 1.1
Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$log_requests boolean Log API requests?
$override boolean
$user_id integer User ID Performing the API Request

Защищенные свойства (Protected)

Свойство Тип Описание
$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