=Minor tweaks to MenuBlock.php

Jake Vanderwerf

2026-08-30 a58a2e7ca4700d3e23341fde767060a4c2c704a3

 inc/registrar/Registrar.php

@@ -14,6 +14,7 @@
use JVBase\registrar\config\Directory;
use JVBase\registrar\config\Feed;
use JVBase\registrar\config\Integration;
use JVBase\registrar\config\Register;
use JVBase\registrar\config\Section;
use JVBase\registrar\config\SEO;
use JVBase\registrar\helpers\AddIntegrationFields;
@@ -52,15 +53,21 @@
   public bool $prefix_post_type = false;
   public string $prefix_with = 'by';

   public bool $system = false;
   public bool $baseless = false;
   public bool $modify = false;

   protected static array $allFlags = [
      //Shared Flags
      'favouritable', 'karma', 'show_feed', 'show_directory', 'approve_new', 'has_responses', 'invitable',
      //Post Flags
      'hide_single', 'redirect_to_author', 'is_calendar', 'single_image', 'is_timeline', 'is_gallery', 'is_faq', 'is_glossary', 'rewrite_taxonomy', 'add_image_column',
      'hide_single', 'redirect_to_author', 'is_calendar', 'single_image', 'is_timeline', 'is_gallery', 'is_faq', 'is_glossary', 'rewrite_taxonomy', 'add_image_column', 'is_profile', 'is_food_menu',
      //Taxonomy Flags
      'is_content', 'is_ownable', 'verify_entry', 'track_changes', 'associate_user_content', 'prefix_post_type',
      //User Flags
      'has_dashboard', 'can_register', 'can_create', 'keep_stats', 'can_favourite', 'member_verified', 'profile_link', 'manage_others'
      'has_dashboard', 'can_register', 'can_create', 'keep_stats', 'can_favourite', 'member_verified', 'profile_link', 'manage_others',
      //System
      'system'
   ];
   /**********************************************************************************************
   SHARED FLAGS
@@ -112,7 +119,7 @@
    * @var bool Whether to make this a calendar type (example: events)
    */
   protected bool $is_calendar = false;
   protected ?MakeCalendarType $isCalendarHandler = null;

   /**
    * @var bool Whether this is a before/after post type
    */
@@ -184,8 +191,10 @@
    * @var bool Whether to generate a profile for this user role
    */
   public bool $profile_link;
   public bool $is_profile = false;
   public bool $is_food_menu = false;
   /**
    * @var array|string
    * @var array
    */
   protected array $can_create = [];
   /**
@@ -208,17 +217,21 @@
   protected Dashboard $dashboard;
   protected Directory|false $directory;
   protected Feed|false $feed;
   protected Register|false $login;
// protected Management $management;
// protected Responses $responses;
   protected ?SEO $seo = null;

   /** Helpers **/
   protected MakeCalendarType|false $calendar = false;
   protected bool $hasIntegrations = true;
   protected array $integrationConfigs = [];
   protected array $integrationFields = [];
   protected MakeTrackChanges $trackChanges;
   protected MakeVerification $verification;

   protected string $umami_event;

   private static array $instances = [];

   protected string $based;
@@ -235,7 +248,10 @@
      $this->setFields();

      add_action('init', [$this, 'register'], 2);
      add_filter('jvbDashboardPage', [$this, 'renderDashPage'], 10, 3);
      if ($this->slug !== 'dash') {
         add_action(BASE.'dashboard_page_'.$this->slug, [$this, 'renderDashPage'], 10, 2);
      }

   }

   public static function maybeExcludeSingles(array $IDs):array
@@ -244,22 +260,19 @@

      $features = ['hide_single', 'is_timeline'];
      foreach ($features as $feature) {
         foreach (self::getFeatured($feature) as $instance) {
         foreach (self::withFeature($feature) as $instance) {
            $instance = self::getInstance($instance);
            $cache = Cache::for('tsf')->connect($instance->getType());
            $cache = Cache::for('tsf', $instance->getType());
            $cache->flush();

            $exclude = $cache->remember(
               $feature,
               function () use ($instance, $feature) {
                  switch ($feature) {
                     case 'hide_single':
                        return $instance->excludeSingle();
                     case 'is_timeline':
                        return $instance->excludeTimeline();
                     default:
                        return [];
                  }
                  return match ($feature) {
                     'hide_single' => $instance->excludeSingle(),
                     'is_timeline' => $instance->excludeTimeline(),
                     default => [],
                  };
               }
            );

@@ -290,13 +303,25 @@
         'post_parent__not_in'   => [0], // Only get posts with a parent
      ]);
   }

   public function ensureRegistrar():void
   {
      $this->initRegistrar();
   }
   protected function initRegistrar():void {
      $this->registrar = match ($this->type) {
         'post' => new Posts($this->slug, $this->singular, $this->plural),
         'term' => new Terms($this->slug, $this->singular, $this->plural),
         default => false,
      };


      if ($this->baseless) {
         $this->registrar->baseless = true;
         $this->registrar->postType = jvbNoBase($this->slug);
      }
      if ($this->modify) {
         $this->registrar->modify = true;
      }
   }

   protected function initClasses():void {
@@ -314,6 +339,8 @@
   /**
    * Instantiates for post types
    * @param string $slug
    * @param string $singular
    * @param string $plural
    * @return self
    */
   public static function forPost(string $slug, string $singular, string $plural):self
@@ -327,6 +354,8 @@
   /**
    * Instantiates for term types
    * @param string $slug
    * @param string $singular
    * @param string $plural
    * @return self
    */
   public static function forTerm(string $slug, string $singular, string $plural):self
@@ -340,6 +369,8 @@
   /**
    * Instantiates for user types
    * @param string $slug
    * @param string $singular
    * @param string $plural
    * @return self
    */
   public static function forUser(string $slug, string $singular, string $plural):self
@@ -350,6 +381,8 @@
      return self::$instances[$slug];
   }



   /**
    * Adds the properties for register_post_type or register_taxonomy
    * @param array $args
@@ -389,6 +422,17 @@
      return $this->args;
   }

   public function baseless():self
   {
      $this->baseless = true;
      return $this;
   }
   public function modify():self
   {
      $this->modify = true;
      return $this;
   }

   public function setFields():void
   {
      $this->fields = new Fields($this->type, $this);
@@ -443,7 +487,7 @@
         error_log('Integration not available for '.$this->slug.': '.$integration);
         return $this;
      }
      $this->integrationConfigs[$integration] = new Integration($integration, $this);
      $this->integrationConfigs[$integration] = new Integration($integration);
      $this->integrationFields[$integration] = new AddIntegrationFields($integration, $this);
      return $this;
   }
@@ -464,11 +508,19 @@
   {
      return $this->integrationConfigs;
   }
   public function hasIntegration(string $integration) {
      return in_array($integration, $this->integrationConfigs);
   public function hasIntegration(string $integration):bool
   {
      if (!$this->hasIntegrations) {
         return false;
      }
      return array_key_exists($integration, $this->integrationConfigs);
   }
    public function hasAnyIntegrations(array $integrations = []):bool
    {
      if (!$this->hasIntegrations) {
         return false;
      }

        if (empty($integrations)) {
            $integrations = array_keys($this->integrationConfigs);
            return !empty($integrations);
@@ -548,6 +600,9 @@
      foreach ($flags as $flag) {
         $this->$flag = true;
         switch ($flag) {
            case 'is_calendar':
               $this->calendar = new MakeCalendarType($this->slug, $this);
               break;
            case 'is_content':
               add_action('init', [$this, 'setupContent'], 20);
               break;
@@ -558,6 +613,24 @@
      }
      return $this;
   }
   public function unsetAll(array $flags):self
   {
      $flags = array_filter($flags, function($flag) {
         return in_array($flag, static::$allFlags);
      });
      foreach ($flags as $flag) {
         $this->$flag = false;
         switch ($flag) {
            case 'is_content':
               remove_action('init', [$this, 'setupContent'], 20);
               break;
            case 'is_glossary':
               $this->hide_single = false;
               break;
         }
      }
      return $this;
   }
   public function prefixWith(string $prefix):self
   {
      $this->prefix_with = sanitize_title($prefix);
@@ -582,8 +655,20 @@
      }
      return isset($this->$feature) && $this->$feature === true;
   }

   /**
    * @deprecated use withFeature
    * @param string $feature
    * @param string|null $type
    * @return array
    */
   public static function getFeatured(string $feature, ?string $type = null):array
   {
      return self::withFeature($feature, $type);
   }

   public static function withFeature(string $feature, ?string $type = null):array
   {
      self::ensureInstanced();

      if (!in_array($feature, static::$allFlags)) {
@@ -592,16 +677,33 @@
      }

      return array_map(function($inst) { return $inst->slug; },array_filter(self::$instances, function ($inst) use ($feature, $type){
         if (!is_null($type) && $inst->type !== $type) {
         if ((!is_null($type) && $inst->type !== $type) || $inst->system) {
            return false;
         }
         return property_exists($inst, $feature) && isset($inst->$feature) && $inst->$feature === true;
      }));
   }

   public static function withIntegration(string $integration, ?string $type = null):array
   {
      self::ensureInstanced();
      Site::getInstance();
      if (!Site::hasIntegration($integration)) {
         error_log('[Registrar]::withIntegration Integration not available to fetch: '.$integration);
         return [];
      }

      return array_map(function($inst) { return $inst->slug; },array_filter(self::$instances, function ($inst) use ($integration, $type){
         if (!is_null($type) && $inst->type !== $type) {
            return false;
         }
         return array_key_exists($integration, $inst->integrationConfigs);
      }));
   }

   public function config(string $config):mixed
   {
      $allowed = ['breadcrumbs','calendar','dashboard','directory','feed','management','has_responses','seo','trackchanges','verification'];
      $allowed = ['breadcrumbs','calendar','register','login','dashboard','directory','feed','management','has_responses','seo','trackchanges','verification'];
      if (!in_array(strtolower($config), $allowed)) {
         error_log('Invalid config requested from Registrar: '.$config);
         return [];
@@ -610,6 +712,7 @@
         'breadcrumbs'  => $this->getBreadcrumbs(),
         'dashboard'    => $this->getDashboard(),
         'directory'    => $this->getDirectory(),
            'register','login' => $this->getLogin(),
         'feed'         => $this->getFeed(),
         'management'   => $this->getManagement(),
         'has_responses'   => $this->getResponses(),
@@ -618,10 +721,17 @@
         'verification' => $this->getVerification()
      };
   }
        protected function getLogin():Register|false
        {
            if (!isset($this->login)) {
                $this->login = new Register();
            }
            return $this->login;
        }
      protected function getBreadcrumbs():Breadcrumbs
      {
         if (!isset($this->breadcrumbs)) {
            $this->breadcrumbs = new Breadcrumbs($this->slug, $this);
            $this->breadcrumbs = new Breadcrumbs($this->slug);
         }

         return $this->breadcrumbs;
@@ -639,7 +749,7 @@
      protected function getDashboard():Dashboard
      {
         if (!isset($this->dashboard)) {
            $this->dashboard = new Dashboard($this->plural, $this);
            $this->dashboard = new Dashboard($this->plural);
         }

         return $this->dashboard;
@@ -672,9 +782,10 @@
   public function getSections():array
   {
      $allSections = array_map(function($section) {
         return $section->getConfig;
         return $section->getConfig();
      }, $this->sections);


      if (!empty($this->sectionOrder)) {
         $allSections['order'] = $this->sectionOrder;
      }
@@ -682,11 +793,40 @@
   }
   public function addSection(string $title):Section
   {
      $section = new Section($title, $this);
      $this->sections[] = $section;
      return $section;
      $slug = sanitize_title($title);
      if (!array_key_exists($slug, $this->sections)) {
         $section = new Section($title, $this);
         $this->sections[$slug] = $section;
      }

      return $this->sections[$slug];
   }

   public static function maybeBuildSections():void
   {
      foreach (self::$instances as $inst) {
         $inst->buildSections();
      }
   }
      protected function buildSections():void
      {
         $fields = $this->getFields();
         $sections = array_unique(array_values(array_map(function ($f) {
            return array_key_exists('section', $f) && !is_null($f['section']) ? $f['section'] : 'main';
         }, $fields)));

         foreach ($sections as $s) {
            $section = new Section($s, $this);
            $section->setTitle(ucwords(implode(' ', explode('-', $s))));
            $sectionFields = array_filter($fields, function ($f) use ($s) {
               $tmp = array_key_exists('section', $f) && !is_null($f['section']) ? $f['section'] : 'main';
               return $s === $tmp;
            });
            $section->setFields(array_keys($sectionFields));
            $this->sections[$s] = $section;
         }
      }

   public function setSectionOrder(array $sections):self
   {
      $allSections = array_map(function($section) {
@@ -734,12 +874,9 @@
            $this->hideSingleHandler = new HideSingle($this->slug, $this);
         }
         if ($this->is_timeline) {
            $this->isTimelineHandler = new MakeTimelineType($this->slug, $this);
            $this->isTimelineHandler = new MakeTimelineType($this->slug);
            $this->registrar->hierarchical = true;
         }
         if ($this->is_calendar) {
            $this->isCalendarHandler = new MakeCalendarType($this->slug, $this);
         }

         if (!is_null($this->rewrite_taxonomy)) {
            $this->registrar->addTaxonomyRewrite($this->rewrite_taxonomy);
@@ -775,6 +912,11 @@
         $this->karmaManager = KarmaManager::for($this->slug, $this->type);
      }
   }

   public function getKarmaManager():?KarmaManager
   {
      return $this->karmaManager;
   }
   public static function getInstance(string $slug):Registrar|false
   {
      self::ensureInstanced();
@@ -800,7 +942,7 @@
   {
      self::ensureInstanced();
      $instances = ($type) ? array_filter(static::$instances, function($instance) use ($type) {
         return $instance->type === $type;
         return $instance->type === $type && !$instance->system;
      }) : static::$instances;
      return array_keys($instances);
   }
@@ -843,16 +985,10 @@
      return $this;
   }

   public function renderDashPage(string $content, string $page, string $slug):string
   public function renderDashPage(string $page, string $slug):void
   {
      if ($slug === $this->slug) {
         ob_start();
         $crud = new CRUD($slug);
         $crud->render();
         return ob_get_clean();
      }

      return $content;
      $crud = new CRUD($slug);
      $crud->render();
   }

   public function setupContent():void
@@ -929,6 +1065,7 @@

            unset($processing[$termId]);
      }

   public function renderContent(string $content, array $block):string
   {
      if (!is_page($this->page)) {
@@ -937,9 +1074,6 @@
      if ($block['blockName'] !== 'core/post-content') {
         return $content;
      }
      if (JVB_TESTING) {
         Cache::for($this->slug)->flush();
      }

        $per_page = 10;
        $page = $_GET['tp']??1;
@@ -956,7 +1090,7 @@
         'order'     => 'desc',
        ]);

        $cache = Cache::for($this->slug)->connect('taxonomy');
        $cache = Cache::for($this->slug, 'term');
      $max = $cache->remember(
         'max',
         function () {
@@ -998,7 +1132,7 @@


      $out = $nav. Cache::for($this->slug)->remember(
         $cache->generateKey(['type' =>'contentArchive', ... $args]),
         ['type' =>'contentArchive', ... $args],
         function() use ($args) {


@@ -1071,8 +1205,8 @@
   public static function ensureInstanced():void
   {
      if (empty(self::$instances)) {
         do_action('jvbDefineRegistrar');
         do_action('jvbDefineRegistrarFields');
         do_action('jvb_define_registrar');
         do_action('jvb_define_fields');
      }
   }

@@ -1095,8 +1229,16 @@

      $this->profile = $slug;

      return Registrar::forPost($slug, $singular, $plural);
      $reg = Registrar::forPost($slug, $singular, $plural);
      $reg->setProfile();

      return $reg;
   }

      public function setProfile():void
      {
         $this->is_profile = true;
      }
   public function getProfile():self|false
   {
      if (!$this->profile_link) {
@@ -1107,7 +1249,7 @@

    public static function getProfileTypes():array
    {
        $hasProfiles = self::getFeatured('profile_link');
        $hasProfiles = self::withFeature('profile_link');
        if (empty($hasProfiles)) {
            return [];
        }
@@ -1117,6 +1259,15 @@
        }, $hasProfiles));
    }

   public function setAsFoodMenu():void
   {
      $this->is_food_menu = true;
   }
      public static function getFoodMenuTypes():array
      {
         return array_map('jvbCheckBase', self::withFeature('is_food_menu'));
      }

   public function setUserSubtype(string $type):self
   {
      $this->user_subtype = sanitize_text_field($type);
@@ -1192,4 +1343,51 @@

      return [$images,$fields];
   }

   public function setHasIntegrations(bool $has = true):void
   {
      $this->hasIntegrations = $has;
   }

   public function isOwnable():bool
   {
      return $this->is_ownable??false;
   }

   public function umamiEvent(string $event):void
   {
      $this->umami_event = str_replace('-', '_', sanitize_title($event));
   }
   public function getUmamiEvent():string
   {
      return $this->umami_event??$this->getDefaultUmamiType();
   }
      protected function getDefaultUmamiType():string
      {
         return match($this->type) {
            'post'   => $this->getDefaultPostUmamiType(),
            'term'   => $this->getDefaultTermUmamiType(),
            'user'   => $this->getDefaultUserUmamiType(),
            default => ''
         };
      }
         protected function getDefaultPostUmamiType():string
         {
            if ($this->is_profile) {
               return 'view_profile';
            }
            return 'view_content';
         }
         protected function getDefaultTermUmamiType():string
         {
            if ($this->is_content) {
               return 'view_collective';
            }
            return 'view_term';
         }
         protected function getDefaultUserUmamiType():string
         {

            return 'view_user';
         }
}