248 lines
7.0 KiB
PHP
248 lines
7.0 KiB
PHP
<?php
|
|
|
|
/**
|
|
* include those two lines at the top of the main plugin file
|
|
*
|
|
* include_once( plugin_dir_path(__FILE__) . '/php/utils/plugin_tools.php');
|
|
* PLGNTOOLS::set_root_dir( plugin_dir_path(__FILE__), plugin_dir_url(__FILE__) );
|
|
*/
|
|
|
|
class PLGNTOOLS
|
|
{
|
|
// static properties to hold the plugin dir path and url
|
|
public static $root_path;
|
|
public static $root_url;
|
|
private static $_ajax_already_there;
|
|
|
|
private $_first_script;
|
|
|
|
public function __construct() {
|
|
if (isset( self::$_ajax_already_there ))
|
|
return ;
|
|
self::$_ajax_already_there = false;
|
|
}
|
|
|
|
public static function set_root_dir($path, $url) {
|
|
if (isset( self::$root_path ))
|
|
return ;
|
|
if (isset( self::$root_url ))
|
|
return ;
|
|
self::$root_path = $path;
|
|
self::$root_url = $url;
|
|
}
|
|
|
|
public function get_path() {
|
|
return(self::$root_path);
|
|
}
|
|
public function get_url() {
|
|
return(self::$root_url);
|
|
}
|
|
|
|
/**
|
|
* js function that create an ajax post action
|
|
* it can be "overloaded" with a callback_response and _error
|
|
*/
|
|
public function get_ajax_script() {
|
|
ob_start();
|
|
?>
|
|
<script type="text/javascript">
|
|
function ajax_post(ajax_data, action) {
|
|
const _ajax_nonce = "<?php echo wp_create_nonce( 'wp-pageviews-nonce' ); ?>";
|
|
const _ajax_url = "<?php echo admin_url( 'admin-ajax.php' ); ?>";
|
|
const data = new FormData();
|
|
data.append('action', action);
|
|
data.append('_ajax_nonce', _ajax_nonce);
|
|
data.append('data', ajax_data);
|
|
|
|
fetch(_ajax_url, {
|
|
method: 'POST',
|
|
credentials: 'same-origin',
|
|
body: data
|
|
})
|
|
.then((response) => response.json())
|
|
.then((data) => {
|
|
console.log("data: ");
|
|
console.log(data);
|
|
})
|
|
.catch((error) => {
|
|
console.log("error: ");
|
|
console.log(error);
|
|
});
|
|
};
|
|
</script>
|
|
<?php
|
|
return ob_get_clean();
|
|
}
|
|
|
|
|
|
/**
|
|
* function that add the ajax script to front
|
|
* no real needs to check if already included :
|
|
* - $handle is uniq so it will not be re-enqueued
|
|
* the first enqueued version would be kept
|
|
* - if we used add_var_to_front() (which use wp_add_inline_script())
|
|
* the vars would be added twice
|
|
* leading to js syntaxe error (redeclaraiton of 'let' or 'const')
|
|
* - but we use wp_localize_script() so the object will be overwritten
|
|
* it's not a real pbm
|
|
* (what is more efficient, check for double or overwritte object ?)
|
|
*/
|
|
public function add_ajax_script() {
|
|
if (is_null($this->_first_script))
|
|
return ;
|
|
if (self::$_ajax_already_there)
|
|
return ;
|
|
|
|
$ajax_script = $this->get_ajax_script();
|
|
wp_add_inline_script($this->_first_script, $ajax_script, 'before');
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
* @param string : name of the file, with its path from its extension directory
|
|
* - from js/ root for .js files
|
|
* - from css/ root for .css files
|
|
* @return object / null :
|
|
* - null if file is not js or css
|
|
* - or an object with all the necessary infos :
|
|
* - ext : name.js -> "js"
|
|
* - basename : name.js -> "name"
|
|
* - handle : name.js -> "name_js"
|
|
* - url : url to file in wordpress
|
|
* - path : path to file in server
|
|
* - version : used to avoid browser caching
|
|
*/
|
|
private function init_file($file_name) {
|
|
$file = (object)[];
|
|
|
|
$file->ext = pathinfo($file_name, PATHINFO_EXTENSION);
|
|
if ($file->ext === "js")
|
|
$dir_path = 'js/';
|
|
else if ($file->ext === "css")
|
|
$dir_path = 'css/';
|
|
else
|
|
return null;
|
|
|
|
$file->basename = pathinfo($file_name, PATHINFO_FILENAME);
|
|
$file->handle = str_replace(".", "_", $file_name);
|
|
|
|
$file->url = $this->get_url().$dir_path.$file_name;
|
|
$file->path = $this->get_path().$dir_path.$file_name;
|
|
$file->version = date("ymd-Gis", filemtime($file->path));
|
|
|
|
return $file;
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* @param array : list of files :
|
|
* - with their path from root of their type of file (ex: from js/ to .js files)
|
|
* - and with their extension
|
|
* @param boolean
|
|
* - to add ajax script and variables
|
|
* - default to true
|
|
*/
|
|
public function add_files_to_front($files_arr, $add_ajax = true) {
|
|
//wp_enqueue_script(<give_it_a_name>, /url/to/file, [depends on], version, defer? );
|
|
//wp_enqueue_style( <give_it_a_name>, /url/to/file, [depends on], version, media );
|
|
|
|
$previous_css_basename = '';
|
|
$previous_js_basename = '';
|
|
foreach ($files_arr as $file_name) {
|
|
$file = $this->init_file($file_name);
|
|
if ($file->ext === "js") {
|
|
if (is_null($this->_first_script))
|
|
$this->_first_script = $file->handle;
|
|
wp_enqueue_script( $file->handle, $file->url, $previous_js_basename, $file->version, true);
|
|
$previous_js_basename = $file->basename;
|
|
}
|
|
else if ($file->ext === "css") {
|
|
wp_enqueue_style( $file->handle, $file->url, $previous_css_basename, $file->version, '');
|
|
$previous_css_basename = $file->basename;
|
|
}
|
|
}
|
|
|
|
if ($add_ajax === true)
|
|
$this->add_ajax_script();
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
* pass variables to js front as global variables
|
|
* @param array : list of key => value
|
|
* with the key being name of the variable, like this :
|
|
* 'my_var' => 'value',
|
|
* simpler way to do it is to use compact when calling the function :
|
|
* add_var_to_front(compact("var1", "var2", "var3"));
|
|
* @param string (optionnal) : name of first embended script that need these variables
|
|
* (it will be available to this script and all followings)
|
|
* this name is the filename + "_" + extension :
|
|
* init.js -> init_js
|
|
*/
|
|
public function add_var_to_front($vars, $handle = null) {
|
|
if (is_null($handle)) {
|
|
$handle = $this->_first_script;
|
|
}
|
|
|
|
extract($vars);
|
|
foreach ($vars as $key => $var)
|
|
{
|
|
$js_var = 'let '.$key.' = '.json_encode($var).';';
|
|
wp_add_inline_script($handle, $js_var, 'before');
|
|
}
|
|
|
|
// the other way with localize has multiple incidences :
|
|
// - it creates an object from wich you can access the variables
|
|
// - so if you call it again wiht the same name, it will overwrite the previous
|
|
// {
|
|
// $handle = pathinfo($handle, PATHINFO_FILENAME);
|
|
// $object_name = "php_data";
|
|
//
|
|
// wp_localize_script($handle, $object_name, $vars);
|
|
// }
|
|
}
|
|
|
|
/**
|
|
* @param two arguments :
|
|
* 1. html files to include in front
|
|
* - can be a string of 1 filename
|
|
* - or an array of strings of filenames
|
|
* ( https://stackoverflow.com/q/4747876/9497573 )
|
|
* - it's probably better to only add 1 file, and let it include other files
|
|
* 2. list of variables to make available to this files
|
|
* - in the form of key => val
|
|
* - recommanded to do it with compact()
|
|
* ex: create_html( "file.html", compact("var1","var2",) );
|
|
* ex: create_html( array("file1.html", "file2.html"), array("var1"=>"value") );
|
|
* @return a string of html code
|
|
*
|
|
* using ob_start() and ob_get_clean()
|
|
* allows to have php expansion inside the html loaded
|
|
* in opposition to the methode file_get_contents()
|
|
*
|
|
* https://stackoverflow.com/a/4402045/9497573
|
|
*/
|
|
function create_html($files, $vars = null) {
|
|
$files = (array)$files;
|
|
$html_dir = $this->get_path().'html/';
|
|
if (!is_null($vars))
|
|
extract($vars);
|
|
|
|
ob_start();
|
|
foreach($files as $file) {
|
|
include($html_dir.$file);
|
|
}
|
|
$html = ob_get_clean();
|
|
|
|
return $html;
|
|
}
|
|
|
|
}
|
|
|
|
|
|
?>
|