プラグインのアップグレード：ウィジェット設定

私はこれについていくつかの研究を試みましたが、まだ確かなものは何も見つかりませんでした。私が作業しているプラ​​グインがあり、前のバージョンと新しいバージョンの間で、（バックエンドの）設定名の一部を変更するウィジェットにいくつかの更新を行いました。これを行うためのアップグレードルーチンの作成に問題があります。

これまで（ほとんど）機能しているように思われるのは次のとおりです。

$widget = get_option( 'widget_name' );

if( is_array( $widget ) && ! empty( $widget ) ) {
    foreach( $widget as $a => $b ) {
        if( ! is_array( $b ) ) {
            continue;
        } 

        foreach( $b as $k => $v ) {
            $widget[$a]['setting1'] = $widget[$a]['oldsetting1'];
            $widget[$a]['setting2'] = $widget[$a]['oldsetting2'];
        }
    }

    update_option( 'widget_name', $widget );
}

ほとんどのテストではこれで問題ありませんが、問題は古いウィジェットが出力を表示しないことです。ウィジェットのタイトルのみが表示されます。個々のウィジェットに移動して保存することでこれを修正でき、それで問題なく動作しますが、ユーザーにそれを実行させたくありません。

私はこのようなものがうまくいくと思った：

$settings = $widgets->get_settings();

foreach( $settings as $s ) {

    $s['setting1'] = $s['oldsetting1'];
    $s['setting2'] = $s['oldsetting2'];

    $widgets->save_settings( $s );

}

ただしsave_settings()、これによりウィジェットが完全に削除されるため、呼び出しは間違っているように思われます。

私はこのような何かのためのあらゆる種類の標準を見つけるのに苦労しています、そしてあなたがこのような何かをするためにあなたがしなければならないかもしれないあらゆる考え、アイデア、またはリンクを聞きたいのです。

助けてくれてありがとう。

編集：

これは、実際には、ライセンスキーの追跡や、WPリポジトリでホストされていないプラグインのアップグレードに関する問題ではありません。これは、ユーザーがアップグレードするときに、プラグインの2つのバージョン間で設定を更新することの詳細です。

例：

バージョン1.0.0には設定フィールドがあります name

バージョン1.1.0では、姓と名の両方が必要であると判断したため、古い設定を変更しfirst_name、新しい設定を追加しますlast_name。

カスタム投稿タイプの投稿メタとして保存されている場合、これらのオプションを転送しても問題ありません。

$old_name = get_post_meta( $post->ID, 'name', true );
$first_name = update_post_meta ( $post->ID, 'first_name', true );
delete_post_meta( $post->ID, 'name' );

その部分は簡単です。私が困っているのは簡単ではないようですが、これと同じことを行うのはウィジェット設定です。

うまくいけば、これで混乱が解消され、簡単に答えられるようになります。

編集2：

echo '<pre>' . print_r( $widget, true ) . '</pre>';上記の最初のコードチャンクからの結果：

Array
(
[2] => Array
    (
        [title] => Class Schedule
        [id] => 23
        [display_type] => grid
        [order] => asc
        [display_title_text] => Events on
        [paging] => 1
        [list_max_num] => 7
        [list_max_length] => days
        [list_start_offset_num] => 0
        [list_start_offset_direction] => back
        [gce_per_page_num] => 7
        [gce_events_per_page] => days
    )

[3] => Array
    (
        [title] => Examples
        [id] => 24
        [display_type] => grid
        [order] => asc
        [display_title_text] => Events on
        [paging] => 1
        [list_max_num] => 7
        [list_max_length] => days
        [list_start_offset_num] => 0
        [list_start_offset_direction] => back
        [gce_per_page_num] => 7
        [gce_events_per_page] => days
    )

[_multiwidget] => 1
)

私はオプションを変更するだけで簡単なテストを行いましたが、うまくいくようです。

私がしたことは：

1. 「タイトル」と「名前」の2つのフィールドのみを持つウィジェットを作成しました。このウィジェットのいくつかのインスタンスをサイドバーに追加します。フロントエンドで正しく表示されることを確認しました。
2. 「Title」と「First Name」の3つのフィールドを使用するようにクラスを編集し（「Name」を置き換えるため）、「Last Name」を追加しました。

3. 'widgets_init'ウィジェットオプションを更新する関数を呼び出すようにウィジェットを登録する関数を編集しました。

   add_action( 'widgets_init', 'my_example_widget_register' );
   
   function my_example_widget_register() {
   
     $widget_name = 'my_example_widget';  // <-- You will probably replace this
   
     $options = get_option("widget_{$widget_name}");
   
     // if the widget is not updated, run a function that updates it
     if ($options && ! get_option("is_{$widget_name}_updated")) {
         // use class below to update options
         $updater = new MyExampleWidgetUpdater($widget_name, $options);
         $updater->update();
     }
   
     register_widget('My_Example_Widget'); // <-- You will probably replace this
   }

4. ウィジェットオプションを更新する単純なクラスを記述します。

   class MyExampleWidgetUpdater
   {
   
     private $name;
     private $options;
   
     public function __construct($name, $options) {
        $this->name = $name;
        $this->options = $options;
     }
   
     public function update() {
       // loop all the options
       array_walk($this->options, function(&$option, $key) {
           if (is_array($option) && is_numeric($key)) {
             $option = $this->getOption($option);
           }
       });
       // update all options in DB
       update_option("widget_{$this->name}", $this->options);
       // set the widget as updated
       update_option("is_{$this->name}_updated", 1);
     }
   
     private function getOption($options) {
       if (!isset($options['name'])) {
          return $options;
       }
       $options['first_name'] = $options['name'];
       $options['last_name'] = '';
       unset($options['name']);
       return $options;
     }
   }

5. ウィジェットクラスを編集して、オプション"is_{$widget_name}_updated"をupdate()メソッド内に保存しました。このようにして、古いウィジェットをインストールしたことがない新しいユーザーに対して、アップデータークラスが呼び出されることはありません。

   class My_Example_Widget {
   
       ...
   
       public function update($new_instance, $old_instance) {
           ...
   
           $widget_name = 'my_example_widget';
           update_option("is_{$widget_name}_updated", 1);
       }
   }

6. 私のサイトを訪問しました。古いオプションで保存されたウィジェットは、新しいオプションを使用しても問題なく表示されます。（もちろん、「姓」は常に空です）。

"is_{$widget_name}_updated"オプションをウィジェットの実際のバージョンを格納するオプションに置き換えることをお勧めします。これにより、次に更新が必要になったときに便利です。

プラグインの更新時にすべての設定を自動アップグレードするのではなく、別の角度から比較検討するだけで、「古い」設定を確認し、その場で「新しい」設定にマッピングします。

function widget( $args, $instance ) {
    if ( isset( $instance['old_setting'] ) )
         $instance = self::_version_compat( $instance );
}

static function _version_compat( $instance ) {
    $instance['new_setting'] = $instance['old_setting'];
    // etc.

    return $instance;
}

私の頭の上で、ウィジェットの各インスタンスには、ある種の一意のIDが与えられています。それがウィジェットのキーのプレフィックスになると言いたいです。

少し前にこれを突っついたのを覚えていますが、申し訳ありませんが、正確な内容を思い出せません。