Existe uma API que eu possa chamar, dentro do meu plug-in, para determinar a versão do plug-in?
Eu só quero que meu plug-in emita um comentário html com seu próprio número de versão ... para fins de diagnóstico.
@david : Ambos @Adam Backtrom e @ Viper007Bond dão alguns bons conselhos, então eu pensei em seguir os seus conselhos e ver se eu não poderia implementar algo, veja abaixo.
O que segue é um plugin chamadoWP Dados de Plugins Ativosque analisa os metadados do cabeçalho para todos os plugins ativos sempre que qualquer plugin é ativado e armazena todos os metadados para cada plugin em uma opção de matriz em wp_options
. Eu o projetei tanto para plugins regulares do WordPress quanto para plugins em todo o site em vários sites. Você pode baixá-lo aqui do Gist mas eu também copiei o código aqui para o seu comentário:
<?php
/*
Plugin Name: WP Active Plugins Data
Plugin URI: http://mikeschinkel.com/wordpress-plugins/wp-active-plugins-data/
Description: Loads Plugin Data on Plugin Activation and Persists to wp_options for quick retrieval.
Version: 0.1
Author: Mike Schinkel
Author URI: http://mikeschinkel.com
Note: Written for http://wordpress.stackexchange.com/questions/361/is-there-a-way-for-a-plug-in-to-get-its-own-version-number
*/
require_once(ABSPATH.'wp-admin/includes/plugin.php');
function get_active_plugin_version($plugin_path_file, $sitewide = false) {
return get_active_plugin_attribute($plugin_path_file,'Version');
}
function get_active_plugin_attribute($plugin_path_file, $attribute) {
$all_plugins_data = get_active_plugins_data($plugin_path_file,$sitewide);
return (isset($all_plugins_data[$attribute]) ? $all_plugins_data[$attribute] : false);
}
function get_active_plugins_data($plugin_path_file, $sitewide = false) {
$failsafe = false;
$plugin = plugin_basename(trim($plugin_path_file));
$sitewide = (is_multisite() && ( $sitewide || is_network_only_plugin($plugin)));
if ($sitewide) {
$all_plugins_data = get_site_option('active_sitewide_plugin_data',array());
} else {
$all_plugins_data = get_option('active_plugin_data',array());
}
if (!$failsafe && !is_array($all_plugins_data) || count($all_plugins_data)==0) {
$failsafe = true; // Don't risk infinite recursion
if ($sitewide) {
$active_plugins = get_site_option('active_sitewide_plugins',array());
} else {
$active_plugins = get_option('active_plugins',array());
}
persist_active_plugin_data(null,$active_plugins,$sitewide);
$all_plugins_data = get_active_plugin_version($plugin_path_file,$sitewide);
}
return $all_plugins_data[$plugin_path_file];
}
add_action('update_site_option_active_sitewide_plugins','persist_sitewide_active_plugin_data',10,2);
function persist_sitewide_active_plugin_data($option, $plugins) {
persist_active_plugin_data(null,$plugins,'sitewide');
}
add_filter('update_option_active_plugins','persist_active_plugin_data',10,2);
function persist_active_plugin_data($old_plugins, $new_plugins, $sitewide=false) {
$active_plugin_data = array_flip($new_plugins);
$plugin_dir = WP_PLUGIN_DIR;
foreach($new_plugins as $plugin) {
$active_plugin_data[$plugin] = get_plugin_data("$plugin_dir/$plugin");
}
if ($sitewide)
update_site_option('active_sitewide_plugin_data',$active_plugin_data);
else
update_site_option('active_plugin_data',$active_plugin_data);
}
Quer ver como funciona? Aqui está um arquivo de teste que você pode colocar na raiz do seu site WordPress (http://example.com/test.php
.) Certifique-se de ter ativado este plugin e o Akismet antes de testá-lo.
<?php
/*
* test.php - Place in root of WordPress website.
*
* Before running be sure to activate both Akismet and the WP Active Plugin Data plugin
*
*/
include "wp-load.php";
header('Content-type:text/plain');
$akismet = "akismet/akismet.php";
echo "Akismet Version: " . get_active_plugin_version($akismet);
echo "\n\nAkismet Description: " . get_active_plugin_attribute($akismet,'Description');
echo "\n\nAll Akismet Data:\n";
print_r(get_active_plugins_data($akismet));
Se não é exatamente o que você precisa, pelo menos, deve dar-lhe um bom ponto de partida. Espero que isto ajude.
Você pode analisar os metadados do seu plugin (essas coisas no topo do arquivo), mas é melhor para o desempenho se você apenas definir sua própria variável PHPcom um número de versão correspondente. Quando você atualizar o plug-in, basta atualizar os dois números de versão.
É um pouco mais trabalho para você no curto prazo, mas muito melhor a longo prazo.
Existe nas telas de administração: get_plugin_data()
. Em modelos, acho que você precisará do plug-in para armazenar esses dados no PHP, por exemplo, definir uma constante ou global ou algo assim, e manter esse valor sincronizado com o número da versão do cabeçalho do plug-in.
wp-settings.php
chama wp_get_active_and_valid_plugins()
, que extrai dados da opção de site active_plugins
. Esta opção contém apenas o caminho para o arquivo de plug-in e wp-settings.php
somente executa include_once
no arquivo, portanto, ele nunca é analisado para os metadados do plug-in.