=Major overhaul of MetaManager.php -> Meta.php and RestRouteManager.php -> ...

Jake Vanderwerf

2026-02-04 2127b1bdd73ecd2423e443992da4b442f5a3c1a3

 inc/rest/routes/FeedRoutes.php

@@ -1,11 +1,10 @@
<?php
namespace JVBase\rest\routes;

use JVBase\managers\CacheManager;
use JVBase\rest\RestRouteManager;
use JVBase\meta\Meta;
use JVBase\rest\Rest;
use JVBase\integrations\Umami;
use JVBase\meta\MetaManager;
use JVBase\managers\TaxonomyRelationships;
use JVBase\rest\Route;
use JVBase\utility\Checker;
use JVBase\utility\Features;
use WP_Query;
@@ -18,7 +17,7 @@
    exit; // Exit if accessed directly
}

class FeedRoutes extends RestRouteManager
class FeedRoutes extends Rest
{
   protected int $per_page = 36;
   protected ?Umami $tracker = null;
@@ -29,42 +28,27 @@

   public function __construct()
   {
      $this->cache_name = 'feed';
      $this->cache_ttl = 86400;
      $this->cacheName = 'feed';
      $this->cacheTtl = 86400;
      parent::__construct();
      $this->cache->clear();
      $this->cache
         ->connect('post', true)
         ->connect('taxonomy', true)
         ->connect('user', true);

      if (JVB_TESTING) {
         $this->cache->flush();
      }

   }

   public function init():void
   {
      $this->cache->clear();
      $this->checker = Checker::getInstance();

      if (jvbSiteUsesUmami()) {
      if (Features::hasIntegration('umami')) {
         $this->tracker = JVB()->connect('umami');
      }
      $this->setupCacheConnections();
   }

   /**
    * Set up cache connections for automatic invalidation
    */
   protected function setupCacheConnections(): void
   {
      // Connect to all content types with show_feed
      $contentTypes = Features::getTypesWithFeature('show_feed', 'content');
      foreach ($contentTypes as $type) {
         CacheManager::for('feed_item_'.$type)->connectTo('post');
         $this->cache->connectTo('post', $type);
      }

      // Connect to all taxonomies with show_feed
      $taxonomies = Features::getTypesWithFeature('show_feed', 'taxonomy');
      foreach ($taxonomies as $tax) {
         CacheManager::for('feed_item_'.$tax)->connectTo('taxonomy');
         $this->cache->connectTo('taxonomy', $tax);
      }

   }

   /**
@@ -73,17 +57,51 @@
    */
   public function registerRoutes(): void
   {
      register_rest_route($this->namespace, '/feed', [
         'methods' => ['GET', 'POST'],
         'callback' => [$this, 'handleFeedRequest'],
         'permission_callback' => [$this, 'checkPermission'],
      ]);
      Route::for('feed')
         ->get([$this, 'handleFeedRequest'])
         ->args([
            'content' => 'string',
            'page' => 'integer|default:1|min:1',
            'taxonomy' => 'string',
            'match' => 'string|enum:all,any|default:all',
            'orderby' => 'string',
            'order' => 'string|enum:ASC,DESC',
            'date-filter' => 'string',
            'dateFrom' => 'string',
            'dateTo' => 'string',
            'context' => 'string',
            'source' => 'string',
            'favourites' => 'boolean',
            'user' => 'integer',
            'highlight' => 'string',
         ])
         ->auth('public')
         ->rateLimit(30, 60)
         ->post([$this, 'handleFeedRequest'])
         ->args([
            'content' => 'string',
            'page' => 'integer|default:1|min:1',
            'taxonomy' => 'string',
            'match' => 'string|enum:all,any|default:all',
            'orderby' => 'string',
            'order' => 'string|enum:ASC,DESC',
            'date-filter' => 'string',
            'dateFrom' => 'string',
            'dateTo' => 'string',
            'context' => 'string',
            'source' => 'string',
            'favourites' => 'boolean',
            'user' => 'integer',
            'highlight' => 'string',
         ])
         ->auth('public')
         ->rateLimit(30, 60);

      register_rest_route($this->namespace, 'feed/types', [
         'permission_callback' => [$this, 'checkPermission'],
         'methods' => 'GET',
         'callback' => [$this, 'getFeedTypes']
      ]);
      // Feed types endpoint
      Route::for('feed/types')
         ->get([$this, 'getFeedTypes'])
         ->auth('public')
         ->rateLimit(60, 60);
   }

   /**
@@ -99,30 +117,33 @@
            $post = get_post($postID);
            $type = jvbNoBase($post->post_type);
            $metaType = 'post';
            $cache = CacheManager::for('feed_item_'.$type);
            break;
         default:
            $post = get_term($postID, jvbCheckBase($type));
            $type = jvbNoBase($type);
            $metaType = 'term';
            $cache = CacheManager::for('feed_item_'.$type);
            break;
      }
      if (!$post || is_wp_error($post)) {
         return [];
      }
//
//    return $cache->remember($postID,
//       function() use ($postID, $type, $metaType, $post, $skip) {

      return $this->cache->remember(
         $postID,
         function() use ($postID, $type, $metaType, $post, $skip) {
            $config = null;
            switch ($metaType) {
               case 'post':
                  $config = JVB_CONTENT[$type];

                  $meta = Meta::forPost($postID);
                  if (!$skip && array_key_exists('is_timeline', $config) && $config['is_timeline']) {
                     return $this->formatTimeline($postID, $post);
                  }
                  break;
               case 'term':

                  $meta = Meta::forTerm($postID);
                  $config = JVB_TAXONOMY[$type];
                  break;
            }
@@ -138,7 +159,6 @@
               }, ARRAY_FILTER_USE_KEY);
            }

            $meta = new MetaManager($postID, $metaType);
            $values = $meta->getAll(array_keys($fields));

            $out = [
@@ -146,33 +166,7 @@
            ];

            //Format Taxonomies
            $temp = array_filter($fields, function($field) {
               return $field['type'] === 'taxonomy';
            });
            foreach ($temp as $key => $config) {
               if (array_key_exists($key, $out['fields']) && $out['fields'][$key] !== '') {
                  $IDs = array_map('absint', explode(',', $out['fields'][$key]));
                  $data = [];
                  $icon = JVB_TAXONOMY[$config['taxonomy']]['icon']??jvbDefaultIcon();
                  foreach ($IDs as $ID) {
                     $term = get_term($ID, jvbCheckBase($config['taxonomy']));
                     if ($term && !is_wp_error($term)) {
                        $data[$ID] = [
                           'id'  => $ID,
                           'icon'   => $icon,
                           'name'   => $term->name,
                           'url' => get_term_link($ID, jvbCheckBase($config['taxonomy'])),
                        ];
                        if ($this->tracker) {
                           $data[$ID]['umami_click'] = $this->tracker->trackClick($ID, $config['taxonomy'], ['from' => $type.'_'.$postID]);
                        }
                     }
                  }
                  if (!empty($data)) {
                     $out['fields'][$key] = $data;
                  }
               }
            }
            $out['taxonomies'] = $this->extractTaxonomies($values, $postID, $type);

            //Add images
            $imgIDs = [];
@@ -208,17 +202,19 @@
                     $out['user_id'] = $owner;
                  }
                  $out['url'] = get_term_link($postID, $type);
                  $out['title'] = html_entity_decode($post->name);
                  break;
               case 'post':
                  $out['date'] = $post->post_date;
                  $out['modified'] = $post->post_modified;
                  $out['user_id'] = (int)$post->post_author;
                  $out['url'] = get_the_permalink($postID);
                  $out['title']= get_the_title($postID);
                  break;
            }
//          return $out;
//       }
//    );
      return $out;
            return $out;
         }
      );
   }


@@ -256,55 +252,107 @@
      }
      $item = $this->formatItem($postID, 'post', true);
      //Step 1: Get the fields that apply to all posts
      $mainMeta = new MetaManager($post->ID, 'post');
      $mainMeta = Meta::forPost($post->ID);
      $item['fields'] = $mainMeta->getAll($this->timelineSharedFields);

      //Step 2: Get the fields for each individual posts
      $children = get_children(['post_parent' => $post->ID, 'orderby' => 'date', 'order' => 'ASC', 'post_status' => ['publish'], 'fields'=> 'ids']);
      array_unshift($children, $post->ID);

      $item['taxonomies'] = $this->extractTaxonomies($item['fields'], $postID, jvbNoBase($post->post_type));

      $subFields = [];
      $images = [];
      foreach ($children as $child) {
         $meta = new MetaManager($child, 'post');
         $meta = Meta::forPost($child);
         $f = $meta->getAll($this->timelineUniqueFields);
         $f =  ['id' => $child] + $f;
         $subFields[] = $f;

         $item['taxonomies'] = array_merge($item['taxonomies'], $this->extractTaxonomies($f, $postID, jvbNoBase($post->post_type)));
         $images[$f['post_thumbnail']] = jvbImageData((int) $f['post_thumbnail']);
      }
      $item['number'] = (int)get_post_meta($post->ID,BASE.'number', true);
      $item['fields']['before'] = get_post_thumbnail_id($children[0]);
      $item['fields']['after'] = get_post_thumbnail_id($children[array_key_last($children)]);

      $item['fields']['timeline'] = $subFields;
      $item['images'] = $item['images'] + $images;


      return $item;
   }
   protected function extractTaxonomies(array $fields, int $postID, string $content):array {
      $taxonomies = [];
      foreach ($fields as $key => $value) {
         if (empty($value)) {
            continue;
         }
         if (!array_key_exists($key, JVB_TAXONOMY)) {
            continue;
         }

   protected function formatTaxonomy(WP_Term $term, int $postID, string $type)
         $taxConfig = JVB_TAXONOMY[$key];
         if (isset($taxConfig['public']) && $taxConfig['public'] === false) {
            continue;
         }
         $terms = array_map('absint', explode(',', $value));
         $terms = array_filter($terms); // Remove 0 values

         if (empty($terms)) {
            continue;
         }
         foreach($terms as $termID) {
            $term = get_term($termID, jvbCheckBase($key));
            if ($term && !is_wp_error($term)) {
               $taxonomies[$key][$termID] = $this->formatTaxonomy($term, $postID, $content);
            }
         }
      }
      return $taxonomies;
   }

   protected function formatTaxonomy(WP_Term|int $term, int $postID, string $type)
   {
      return [
         'ID' => $term->term_id,
         'title' => htmlspecialchars_decode($term->name),
         'url' => get_term_link($term->term_id, $term->taxonomy),
         'umami_click' => $this->tracker->trackTaxonomyClick($term->term_id, $term->taxonomy, [
            'from' => $type . '_' . $postID
         ])
      ];
      return $this->cache->remember(
         $term->term_id,
         function () use ($term, $postID, $type) {
            $base = [
               'ID' => $term->term_id,
               'title' => html_entity_decode($term->name),
               'url' => get_term_link($term->term_id, $term->taxonomy),
            ];
            if ($this->tracker) {
               $base['umami_click'] =$this->tracker->trackTaxonomyClick($term->term_id, $term->taxonomy, [
                  'from' => $type . '_' . $postID
               ]);
            }
            return $base;
         }
      );
   }

   protected function getAuthorData(WP_Post $post)
   {
      $author = $this->cache->get($post->post_author, 'author_data');
      if (!$author) {
         $author = [
            'id' => $post->post_author,
            'label' => 'Artist',
            'value' => get_the_author_meta('display_name', $post->post_author),
            'icon' => 'artist',
            'url' => get_the_permalink(get_user_meta($post->post_author, BASE . 'link', true)),
         ];
         $this->cache->set($post->post_author, $author, 'author_data');
      }
      return $author;
      $author = $post->post_author;
      $userLink = get_user_meta($author, BASE.'link', true);
      return $this->cache->remember(
         $userLink,
         function () use ($userLink, $author) {
            $label = jvbUserRole($author);
            if (array_key_exists($label, JVB_USER)) {
               $label = JVB_USER[$label]['label'];
            } else {
               $label = 'Artist';
            }
            return [
               'id'  => $userLink,
               'label'  => $label,
               'value'  => get_the_title($userLink),
               'icon'   => 'user',
               'url' => get_the_permalink($userLink),
            ];
         }
      );
   }

   protected function getTaxonomies(int $postID, string $content): array
@@ -320,16 +368,23 @@
               'icon' => $config,
               'title' => JVB_TAXONOMY[$config]['plural'],
               'terms' => array_map(function ($term) use ($tax, $postID, $content) {
                  return [
                     'ID' => $term->term_id,
                     'title' => htmlspecialchars_decode($term->name),
                     'url' => get_term_link($term->term_id, $tax),
                     'umami_click' => $this->tracker->trackTaxonomyClick($term->term_id, $tax, [
                        'from' => $content . '_' . $postID
                     ])
                  ];
                  $item = $this->cache->remember(
                     $term->term_id,
                     function() use ($term, $tax, $content, $postID) {
                        return [
                           'ID'  => $term->term_id,
                           'title'  => html_entity_decode($term->name),
                           'url' => get_term_link($term->term_id, $tax),
                        ];
                     }
                  );
                  $item['umami_click'] = $this->tracker->trackTaxonomyClick($term->term_id, $tax, [
                     'from'   => $content.'_'.$postID
                  ]);
                  return $item;
               }, $terms),
            ];

         }
      }
      return $out;
@@ -363,46 +418,7 @@
      $args = $this->applyOrderFilters($args, $data);
      $args = $this->applyDateFilters($args, $data);

      $args = $this->applyFavouritesFilter($args, $data);
      return $args;
   }

   protected function applyTaxonomyFilters(array $args, array $data): array
   {
      if (!isset($data['taxonomy']) || empty($data['taxonomy'])) {
         return $args;
      }

      $taxonomyFilters = $data['taxonomy'];

      // Validate taxonomies exist and sanitize
      $validFilters = [];
      foreach ($taxonomyFilters as $taxonomy => $terms) {
         if (!taxonomy_exists(jvbCheckBase($taxonomy))) {
            continue;
         }

         $validFilters[] = [
            'taxonomy' => jvbCheckBase($taxonomy),
            'field' => 'term_id',
            'terms' => array_map('absint', (array)$terms),
            'operator' => 'IN'
         ];
      }

      if (empty($validFilters)) {
         return $args;
      }

      // Determine relation based on match filter
      $relation = ($data['match'] ?? 'all') === 'all' ? 'AND' : 'OR';

      $args['tax_query'] = array_merge(
         ['relation' => $relation],
         $validFilters
      );

      return $args;
      return $this->applyFavouritesFilter($args, $data);
   }

   /**
@@ -413,19 +429,17 @@
   public function handleFeedRequest(WP_REST_Request $request): WP_REST_Response
   {
      $args = $this->buildRequestArgs($request);
      $cacheContext = $this->buildCacheContext($args, $request);
      $key = $this->cache->generateKey($args);

      // Check HTTP cache headers first
      $cache_check = $this->checkHeaders(
         $request,
         $cacheContext['content_types'],
         $cacheContext['additional_params']
         $key
      );
      if ($cache_check) {
         return $cache_check; // Returns 304 Not Modified
      }

      $key = $this->cache->generateKey($args);
      $cached = $this->cache->get($key);
      if ($cached) {
         if ($request->get_param('highlight')) {
@@ -433,13 +447,13 @@
            $args['highlight'] = $highlight;
         }
         $cached['items'] = $this->processHighlightedItem($cached['items'], $args);
         $response = new WP_REST_Response($cached);
         $response = $this->success($cached);
         return $this->addCacheHeaders($response);
      }
      // Fetch and format items
      $items = $this->fetchFeedItems($args);

      $ttl = (str_contains($args['orderby'], 'RAND')) ? 1800 : $this->cache_ttl;
      $ttl = (str_contains($args['orderby'], 'RAND')) ? 300 : $this->cacheTtl;
      $this->cache->set($key, $items, $ttl);

      if ($request->get_param('highlight')) {
@@ -448,86 +462,12 @@
      }

      $items['items'] = $this->processHighlightedItem($items['items'], $args);
      $response = new WP_REST_Response($items);
      $response = $this->success($items);
      return $this->addCacheHeaders($response);
   }

   /**
    * Build cache context from query args
    * Extracts content types and parameters needed for proper cache checking
    *
    * @param array $args Built WP_Query arguments
    * @param WP_REST_Request $request Original request
    * @return array Cache context with content_types and additional_params
    */
   protected function buildCacheContext(array $args, WP_REST_Request $request): array
   {
      // Extract content types from post_type in args
      $post_types = is_array($args['post_type'])
         ? $args['post_type']
         : [$args['post_type']];

      $content_types = array_map('jvbNoBase', $post_types);
      $content_types[] = 'feed'; // Always include base feed type

      // Build additional params for ETag uniqueness
      $additional_params = [
         'order' => $args['orderby'] ?? 'date',
         'direction' => $args['order'] ?? 'DESC',
         'page' => $args['paged'] ?? 1,
      ];

      if ($request->get_param('favourites')) {
         $additional_params['user'] = (int)$request->get_param('user');
      }

      // Include author filter if present (from context or favourites)
      if (!empty($args['author'])) {
         $additional_params['author'] = $args['author'];
      }

      if (!empty($args['author__in'])) {
         $additional_params['author__in'] = $args['author__in'];
      }

      // Include taxonomy filters if present
      if (!empty($args['tax_query'])) {
         $tax_filters = [];
         foreach ($args['tax_query'] as $key => $query) {
            if ($key === 'relation' || !is_array($query)) {
               continue;
            }

            $taxonomy = jvbNoBase($query['taxonomy'] ?? '');
            if ($taxonomy) {
               $tax_filters[$taxonomy] = $query['terms'] ?? [];
               // Also add taxonomy to content_types for timestamp checking
               $content_types[] = $taxonomy;
            }
         }
         if (!empty($tax_filters)) {
            $additional_params['taxonomies'] = $tax_filters;
         }
      }

      // Include date filters if present
      if (!empty($args['date_query'])) {
         $additional_params['date_filter'] = md5(serialize($args['date_query']));
      }

      // Include meta queries if present
      if (!empty($args['meta_query'])) {
         $additional_params['meta_filter'] = md5(serialize($args['meta_query']));
      }

      return [
         'content_types' => array_unique($content_types),
         'additional_params' => $additional_params
      ];
   }

   /**
    * @param array $args Formatted Args for WP_Query
    * @param array $items Formatted Args for WP_Query
    * @param array $data parsed Request Data
    *
    * @return array|null
@@ -581,35 +521,39 @@
               : explode(',', $args['post_type']);

            // Check if filtering global feed content
            $globalFeedTypes = array_map('jvbCheckBase',
               array_keys(Features::getTypesWithFeature('show_feed', 'content'))
            );

            if (array_intersect($args['post_type'], $globalFeedTypes)) {
               $artists = jvbGetContentUsers($context['id']);
               if (!empty($artists)) {
                  $args['author__in'] = $artists;
            if (in_array($context['type'], jvbGlobalFeedContentTaxonomies())) {
               // Global: show posts from any content type with this taxonomy
               $for_content = JVB_TAXONOMY[$context['type']]['for_content'] ?? [];
               if (empty($for_content)) {
                  // Fall back to any content that has this taxonomy registered
                  $for_content = array_keys(
                     array_filter(
                        JVB_CONTENT,
                        fn($c) => in_array($context['type'], $c['taxonomies'] ?? [])
                     )
                  );
               }
            } else {
               $args['tax_query'] = [
                  'relation' => 'AND',
                  [
                     'taxonomy' => BASE . $context['type'],
                     'terms' => $context['id'],
                  ]
               ];

               // Convert to full post types with BASE prefix
               $post_types = array_map(fn($type) => BASE . $type, $for_content);

               // Filter to only show_feed content types
               $show_feed_types = Features::getTypesWithFeature('show_feed', 'content');
               $args['post_type'] = array_intersect(
                  $post_types,
                  array_map(fn($type) => BASE . $type, $show_feed_types)
               );
            }
            break;
         case taxonomy_exists(jvbCheckBase($context['type'])):
            $args['tax_query'] = [
               'relation' => 'AND',
               [
                  'taxonomy' => BASE . $context['type'],
                  'terms' => $context['id'],
               ]

            // Add term to tax query
            $args['tax_query'][] = [
               'taxonomy' => jvbCheckBase($context['type']),
               'field' => 'term_id',
               'terms' => [(int)$context['id']],
            ];
            break;
      }

      return $args;
   }

@@ -619,38 +563,34 @@
    *
    * @return array
    */
   protected function applyFavouritesFilter(array $args, array $filters): array
   protected function applyFavouritesFilter(array $args, array $data): array
   {
      if (!array_key_exists('favourites', $filters)) {
      if (empty($data['favourites']) || empty($data['user'])) {
         return $args;
      }
      global $wpdb;

      // Get post types for the current filter
      $post_types = is_array($args['post_type'])
         ? $args['post_type']
         : [$args['post_type']];
      $user_id = (int)$data['user'];
      $content = jvbNoBase($args['post_type']);

      $favourites_table = $wpdb->prefix . BASE . 'favourites';
      $placeholders = implode(',', array_fill(0, count($post_types), '%s'));
      $favourited_ids = $wpdb->get_col($wpdb->prepare(
         "SELECT target_id FROM {$favourites_table}
            WHERE user_id = %d AND type IN ($placeholders)",
         array_merge(
            [get_current_user_id()],
            $post_types
         )
      ));
      // Get user's favourites for this content type
      $fav_key = BASE . 'favourites_' . $content;
      $favourites = get_user_meta($user_id, $fav_key, true);

      if (empty($favourited_ids)) {
         // Force empty results
      if (empty($favourites)) {
         // No favourites - return empty result
         $args['post__in'] = [0]; // Will return no results
         return $args;
      }

      $fav_ids = array_filter(array_map('intval', explode(',', $favourites)));

      if (empty($fav_ids)) {
         $args['post__in'] = [0];
         return $args;
      }

      $args['post__in'] = isset($args['post__in'])
         ? array_intersect($args['post__in'], $favourited_ids)
         : $favourited_ids;
      $args['post__in'] = $fav_ids;
      $args['orderby'] = 'post__in'; // Preserve favourite order

      return $args;
   }
@@ -1219,7 +1159,7 @@

      $feedTypes = $this->buildFeedTypesConfig();

      $response = new WP_REST_Response($feedTypes);
      $response = $this->success($feedTypes);
      return $this->addCacheHeaders($response);
   }

@@ -1243,6 +1183,7 @@
            // Get content types with show_feed
            $contentTypes = Features::getTypesWithFeature('show_feed', 'content');
            foreach ($contentTypes as $slug) {
               $this->cache->tag('content:'.$slug);
               $contentConfig = JVB_CONTENT[$slug] ?? null;
               if (!$contentConfig) continue;

@@ -1263,6 +1204,8 @@
                  continue;
               }

               $this->cache->tag('taxonomy:'.$slug);

               $config[$slug] = [
                  'type' => 'taxonomy',
                  'singular' => $taxConfig['singular'] ?? ucfirst($slug),