Как устанавливать и использовать глобальные переменные? Или почему лучше их не использовать

Не используйте глобальные переменные, вот и всё.

Почему не стоит использовать глобальные переменные

Потому что использование глобальных переменных усложняет поддержку программного обеспечения в долгосрочной перспективе.

• Глобальная переменная может быть объявлена где угодно в коде или вообще нигде, поэтому нет конкретного места, где можно интуитивно найти комментарий о её назначении
• При чтении кода обычно предполагается, что переменные локальны для функции, и не осознаётся, что изменение их значения в функции может повлиять на всю систему
• Если функции не обрабатывают ввод, они должны возвращать одно и то же значение/выходные данные при одинаковых параметрах. Использование глобальных переменных в функции вводит дополнительные параметры, которые не задокументированы в объявлении функции
• Глобальные переменные не имеют специфического конструктора инициализации, поэтому никогда нельзя быть уверенным, когда к ним можно обратиться, и не будет ошибки при попытке доступа до инициализации
• Кто-то другой (например, плагин) может использовать глобальные переменные с тем же именем, нарушая ваш код, или вы — его, в зависимости от порядка инициализации

В ядре WordPress глобальные переменные используются чрезмерно много. При попытке понять, как работают базовые функции и хуки, такие как the_content, внезапно осознаёшь, что переменная $more не локальная, а глобальная, и приходится искать по всем файлам ядра, чтобы понять, когда она устанавливается в true.

Так что же делать, если нужно избежать копирования-вставки нескольких строк кода вместо сохранения результата первого запуска в глобальной переменной? Есть несколько подходов: функциональный и ООП.

Функция-обёртка. Это просто макрос для сохранения копирования/вставки:

// вход: $id — идентификатор категории
// возвращает: значение foo2 для категории
function notaglobal($id) {
  $a = foo1($id);
  $b = foo2($a);
  return $b;
}

Преимущества в том, что теперь есть документация о назначении бывшей глобальной переменной, а также очевидная точка для отладки, если возвращаемое значение не соответствует ожиданиям.

Если есть функция-обёртка, легко кэшировать результат при необходимости (делайте это только если обнаружите, что функция выполняется долго):

function notaglobal($id) {
  static $cache;
  
  if (!isset($cache)) {
    $a = foo1($id);
    $b = foo2($a);
    $cache = $b;
  } 
  return $cache;
} 

Это даёт то же поведение, что и глобальная переменная, но с гарантированной инициализацией при каждом доступе.

Аналогичные шаблоны можно реализовать в ООП. Я считаю, что ООП обычно не добавляет ценности в плагинах и темах, но это отдельная тема:

class notaglobal {
   var latestfoo2;

   __constructor($id) {
     $a = foo1($id);
     $this->latestfoo2 = foo2($a)
   }
}

$v = new notaglobal($cat_id);
echo $v->latestfoo2;

Это менее элегантный код, но если нужно предварительно вычислить несколько значений, которые всегда используются, такой подход возможен. По сути, это объект, содержащий все глобальные переменные в организованном виде. Чтобы избежать создания глобального экземпляра этого объекта (нужен только один экземпляр, иначе значения пересчитываются), можно использовать шаблон одиночки (singleton) (некоторые считают это плохой идеей, на ваше усмотрение).

Мне не нравится прямой доступ к атрибутам объекта, поэтому в моём коде будет ещё одна обёртка:

class notaglobal {
   var latestfoo2;

   __constructor() {}

   foo2($id) {  
     if (!isset($this->latestfoo2)) {    
       $a = foo1($id);
       $b = foo2($a);
       $this->latestfoo2= $b;
     } 
     return $this->latestfoo2;
   }
}

$v = new notaglobal();
echo $v->foo2($cat_id);

Ваш вопрос связан с тем, как работает PHP.

Возьмем $wpdb в качестве примера.

$wpdb — это известная глобальная переменная.

Вы знаете, когда она объявляется и получает значения?

При каждой загрузке страницы, да, каждый раз, когда вы посещаете свой сайт на WordPress.

Аналогично, вам нужно убедиться, что переменные, которые вы хотите сделать глобальными, объявляются и получают соответствующие значения при каждой загрузке страницы.

Хотя я не дизайнер тем, я могу сказать, что after_setup_theme — это одноразовый хук. Он срабатывает только при активации темы.

Если бы я был на вашем месте, я бы использовал init или другие хуки. Хотя нет, если бы я был на вашем месте, я бы вообще не использовал глобальные переменные...

Я не очень хорошо объясняю. Так что, если хотите углубиться в PHP, вам стоит взять книгу.

Вы всегда можете использовать шаблон Singleton через статические геттеры.

<ul>
    <li><?php echo MyGlobals::get_nav_prop( 'proposal' )[ 'html' ]; ?></li>
    <li><?php echo MyGlobals::get_nav_prop( 'calvinball', 'html' ); ?></li>
</ul>


<?php

if ( ! class_exists('MyGlobals') ):

class MyGlobals {

    public $props;

    public function __construct(){
      $this->props = array (
        'proposal' => array( 'title' => 'Предложение', 'text' => 'Предложение' ),
        'calvinball' => array( 'title' => 'Кальвинбол', 'text' => 'Кальвинбол' ),
      );
    }

    public function get_nav_prop ( $term, $prop = false )
    {
      $o = self::instance();
      if ( ! isset( $o->props[$term] ) ) {  return false; }
      if ( ! isset( $o->props[$term][ 'html' ] ) ) {
          $id = get_cat_ID( $term );
          $link = esc_url ( get_category_link( $id ) );
          $title = $o->props[$term]['title'];
          $text = $o->props[$term]['text'];
          $o->props[$term]['html'] = '<a href="'.$link.'" title="'.$title.'">'.$text.'</a>';
          $o->props[$term]['link'] = $link;
          $o->props[$term]['id'] = $id;
      }

      if($prop){ return isset($o->props[$term][$prop]) ? $o->props[$term][$prop] : null; }

      return $o->props[$term];
    }

    // -------------------------------------

    private static $_instance;

    public static function instance(){

      if(!isset(self::$_instance)) {
        self::$_instance = new MyGlobals();
      }
      return self::$_instance;
    }

}

endif; // end MyGlobals