| 1 |
<?php |
| 2 |
namespace WPDeveloper\BetterDocs\Utils; |
| 3 |
|
| 4 |
class Enqueue extends Base { |
| 5 |
private $plugin_url; |
| 6 |
private $plugin_path; |
| 7 |
private $version; |
| 8 |
|
| 9 |
public function __construct( $plugin_url, $plugin_path, $version ) { |
| 10 |
$this->plugin_url = $plugin_url; |
| 11 |
$this->plugin_path = $plugin_path; |
| 12 |
$this->version = $version; |
| 13 |
} |
| 14 |
|
| 15 |
public function enqueue( $handle, $filename, $dependencies = [], $args = null ) { |
| 16 |
$config = $this->asset_config( $filename, $dependencies, $args ); |
| 17 |
$this->call_wp_func( 'wp_enqueue', $handle, $config ); |
| 18 |
} |
| 19 |
|
| 20 |
public function register( $handle, $filename, $dependencies = [], $args = null ) { |
| 21 |
$config = $this->asset_config( $filename, $dependencies, $args ); |
| 22 |
$this->call_wp_func( 'wp_register', $handle, $config ); |
| 23 |
} |
| 24 |
|
| 25 |
public function localize( $handle, $name, $args ) { |
| 26 |
wp_localize_script( $handle, $name, $args ); |
| 27 |
} |
| 28 |
|
| 29 |
private function call_wp_func( $action, $handle, $config ) { |
| 30 |
call_user_func( |
| 31 |
$action . '_' . $config['type'], |
| 32 |
$handle, |
| 33 |
$config['url'], |
| 34 |
$config['dependencies'], |
| 35 |
$config['version'], |
| 36 |
$config['args'] |
| 37 |
); |
| 38 |
|
| 39 |
if ( 'script' === $config['type'] && in_array( 'wp-i18n', $config['dependencies'], true ) ) { |
| 40 |
$url = isset( $config['url'] ) ? $config['url'] : ''; |
| 41 |
preg_match( '~/plugins/([^/]+)~', $url, $matches ); |
| 42 |
$url_portion = isset( $matches[1] ) ? $matches[1] : ''; |
| 43 |
if ( $url_portion == 'betterdocs-pro' ) { |
| 44 |
wp_set_script_translations( $handle, 'betterdocs-pro' ); |
| 45 |
} elseif ( $url_portion == 'betterdocs-ai-chatbot' ) { |
| 46 |
wp_set_script_translations( $handle, 'betterdocs-ai-chatbot' ); |
| 47 |
} elseif ( $url_portion == 'betterdocs' ) { |
| 48 |
wp_set_script_translations( $handle, 'betterdocs' ); |
| 49 |
} |
| 50 |
} |
| 51 |
} |
| 52 |
|
| 53 |
public function asset_config( $filename, $dependencies = [], $args = null ) { |
| 54 |
$is_js = preg_match( '/\.js$/', $filename ); |
| 55 |
$basename = preg_replace( '/\.\w+$/', '', $filename ); |
| 56 |
$url = $this->asset_url( $filename ); |
| 57 |
$version = $this->version; |
| 58 |
$asset_config_path = $this->dist_path( $basename . '.asset.php' ); |
| 59 |
|
| 60 |
if ( file_exists( $asset_config_path ) ) { |
| 61 |
$asset_config = require $asset_config_path; |
| 62 |
|
| 63 |
if ( $is_js ) { |
| 64 |
$dependencies = array_unique( array_merge( $asset_config['dependencies'], $dependencies ) ); |
| 65 |
} |
| 66 |
$version = $asset_config['version']; |
| 67 |
} |
| 68 |
|
| 69 |
return [ |
| 70 |
'url' => $url, |
| 71 |
'dependencies' => $dependencies, |
| 72 |
'version' => $version, |
| 73 |
'type' => $is_js ? 'script' : 'style', |
| 74 |
'args' => null !== $args ? $args : ( $is_js ? true : 'all' ) |
| 75 |
]; |
| 76 |
} |
| 77 |
|
| 78 |
/** |
| 79 |
* Resolve the assets sub-folder for a file: webpack output lives under |
| 80 |
* assets/build/, committed static assets under assets/static/. Prefer the |
| 81 |
* build copy when present, otherwise fall back to static. This lets every |
| 82 |
* enqueue/register call use the same relative path regardless of which |
| 83 |
* folder the file ends up in. |
| 84 |
* |
| 85 |
* The final `assets/` fallback matters for the Free/Pro version skew this |
| 86 |
* class is shared across. Pro constructs this same Enqueue against its OWN |
| 87 |
* plugin path, so when Free 4.8.0 runs alongside a Pro that predates the |
| 88 |
* Node 24 restructure, Pro's files are still flat under assets/. Without |
| 89 |
* this branch every one of them resolved to a non-existent assets/static/ |
| 90 |
* path and 404'd. Ordering is deliberate: a matched pair never reaches the |
| 91 |
* legacy branch, so this costs nothing in the normal case. |
| 92 |
* |
| 93 |
* Kept `protected` so a paired plugin can refine the search order. |
| 94 |
*/ |
| 95 |
protected function asset_base( $filename ) { |
| 96 |
foreach ( [ 'assets/build/', 'assets/static/', 'assets/' ] as $base ) { |
| 97 |
if ( file_exists( path_join( $this->plugin_path, $base . $filename ) ) ) { |
| 98 |
return $base; |
| 99 |
} |
| 100 |
} |
| 101 |
|
| 102 |
// Nothing on disk — keep the historical default so a genuinely missing |
| 103 |
// file produces the same (broken) URL it always did, not a new shape. |
| 104 |
return 'assets/static/'; |
| 105 |
} |
| 106 |
|
| 107 |
public function asset_url( $filename ) { |
| 108 |
if ( filter_var( $filename, FILTER_VALIDATE_URL ) ) { |
| 109 |
return $filename; |
| 110 |
} |
| 111 |
|
| 112 |
return esc_url( $this->plugin_url . $this->asset_base( $filename ) . $filename ); |
| 113 |
} |
| 114 |
|
| 115 |
/** |
| 116 |
* Explicit URL for a committed static asset under assets/static/. |
| 117 |
*/ |
| 118 |
public function static_url( $filename ) { |
| 119 |
if ( filter_var( $filename, FILTER_VALIDATE_URL ) ) { |
| 120 |
return $filename; |
| 121 |
} |
| 122 |
|
| 123 |
return esc_url( $this->plugin_url . 'assets/static/' . $filename ); |
| 124 |
} |
| 125 |
|
| 126 |
public function dist_path( $file ) { |
| 127 |
return path_join( $this->plugin_path, $this->asset_base( $file ) . $file ); |
| 128 |
} |
| 129 |
|
| 130 |
public function icon( $name, $is_admin = false ) { |
| 131 |
$_path = $is_admin ? 'assets/static/admin/images/' : 'assets/static/images/'; |
| 132 |
return esc_url( $this->plugin_url . $_path . $name . '?v=' . $this->version ); |
| 133 |
} |
| 134 |
} |
| 135 |
|
