<?php
|
namespace JVBase\integrations;
|
|
use JVBase\managers\Cache;
|
use JVBase\managers\IconsManager;
|
|
if (!defined('ABSPATH')) {
|
exit;
|
}
|
|
trait _Base {
|
/**
|
* @var string Unique identifier for this service (ex: square, facebook)
|
*/
|
protected string $service_name;
|
/**
|
* @var int|null The user context. If it is an OAuth integration, users may have their own connections, accessible via their user id
|
*/
|
protected ?int $userID = null;
|
/**
|
* @var string Human-readable service name (ex: 'Google My Business', 'Square', etc)
|
*/
|
public string $title;
|
/**
|
* @var string Phosphoricons icon slug
|
*/
|
public string $icon = '';
|
/**
|
* @var string API version string (ex: 'v2', '2024-01-01')
|
*/
|
protected string $apiVersion;
|
protected Cache $cache;
|
//Use Trait "Requests" to set this
|
protected bool $hasRequests = false;
|
protected ?RateLimits $requestLimiter = null;
|
//Use Trait "OAuth" to set this
|
protected ?RateLimits $oauthLimiter = null;
|
protected bool $hasOAuth = false;
|
//Use trait "Webhooks" to set this true
|
protected bool $hasWebhooks = false;
|
|
/**
|
* @var array Each item in the array becomes a li element in the ordered list of instructions
|
*/
|
protected array $instructions = [];
|
/**
|
* @var array The required fields for the credentials. Typically a site_key/secret_key or equivalent.
|
*/
|
protected array $credentialFields = [];
|
/**
|
* @var array The required fields for OAuth connection
|
*/
|
protected array $oauthFields = [];
|
/**
|
* @var array Optional fields that just tweak functionality
|
*/
|
protected array $optionalFields = [];
|
protected bool $supportsWebp = true;
|
/**
|
* @var bool Flag to indicate there are extra options that warrant a dedicated options page for this service
|
* Usually used for default field values for syncable services
|
*/
|
public bool $hasExtraOptions = false;
|
|
|
|
|
/**
|
* Check if integration is properly configured
|
*/
|
public function isSetUp(): bool
|
{
|
return !empty($this->loadCredentials());
|
}
|
|
public function loadCredentials():array
|
{
|
return Auth::getInstance()->getCredentials($this->service_name, $this->userID);
|
}
|
|
protected function logError(string $method, string $message, array $context = []):void
|
{
|
$context['service'] = $this->service_name;
|
JVB()->error()->log('['.self::class.']'.$method, $message, $context);
|
}
|
|
protected function getReturnURL():string
|
{
|
//If we are on the main admin page, we want to go back to our Integrations page on admin
|
//If we are on the custom dashboard, we want to go back to that dashboard page
|
return is_admin() ?
|
admin_url('admin.php?page=jvb-integrations') :
|
get_home_url(null, '/dash/integrations/');
|
}
|
protected function determineOptionPage():string
|
{
|
return is_admin() ?
|
admin_url('admin.php?page=jvb-integrations-'.$this->service_name) :
|
get_home_url(null, '/dash/integrations/'.$this->service_name.'/');
|
}
|
|
protected function outputIcon(string $icon):string
|
{
|
if (is_admin()) {
|
$icons = IconsManager::for('admin');
|
return $icons->getRawSvg($icon);
|
}
|
return jvbDashIcon($icon);
|
}
|
}
|
