name) * @return bool true if the key exists * @since 7.0.2 */ public function __isset(string $key): bool { return isset($this->config[$key]); } /** * Magic method to get protected properties by key. * This is called when reading data from inaccessible properties. * * @param string $key The key requested (e.g., 'name' for $class->name) * @return mixed|null The value from the $param array or null if the key doesn't exist * @since 7.0.0 */ public function __get(string $key): mixed { // Check if the key exists in the protected array if (\array_key_exists($key, $this->config)) { // Ensure array when nothing using default value if (\in_array($key, ['latestCategory', 'rssExcludedCategories', 'rssIncludedCategories'])) { if (!\is_array($this->config[$key])) { $this->config[$key] = [$this->config[$key]]; } } // Ensure minimum value if (\in_array($key, ['messagesPerPage', 'messagesPerPageSearch', 'threadsPerPage'])) { $this->config[$key] = max($this->config[$key], 1); } if ($key === 'email') { return !empty($this->config[$key]) ? $this->config[$key] : Factory::getApplication()->get('mailfrom', ''); } // Return the value return $this->config[$key]; } throw new \Exception('Trying to get non-existing property: ' . $key, 500); } /** * Magic method to set inaccessible properties. * This is called when writing data to inaccessible properties. * It allows setting a configuration value only if the key already exists * in the loaded configuration array. * * @param string $key The key requested (e.g., 'name' for $class->name) * @param mixed $value The value to set * @return void * @since 7.0.0 */ public function __set(string $key, mixed $value): void { // Only set the value if the key is already present in the config array if (\array_key_exists($key, $this->config)) { $this->config[$key] = $value; return; } throw new \Exception('Trying to set non-existing property: ' . $key, 500); } /** * Get an instance of KunenaConfig * * @return ?KunenaConfig * @since 7.0.0 */ public static function getInstance(): ?KunenaConfig { if (\null === self::$instance) { $instance = new KunenaConfig(); $instance->config = self::getCachedConfig(); self::$instance = $instance; } return self::$instance; } /** * Function to build the configuration values with default values from config.xml * * @return array * @since 7.0.0 */ private static function buildConfig(): array { $config = []; $params = ComponentHelper::getParams(self::COMPONENT); $defaults = self::getXmlDefaults(JPATH_ADMINISTRATOR . '/components/' . self::COMPONENT . '/config.xml'); foreach ($defaults as $name => $default) { $config[$name] = $params->get($name, $default); } return $config; } /** * Function to build the configuration values with default values from config.xml and fill it with values * * @return array * @since 7.0.2 */ public function getConfigReport(): array { return $this->buildConfig(); } /** * Function to get the cached (or create when not existing) configuration settings * * @return array * @since 7.0.0 */ private static function getCachedConfig(): array { /** @var CallbackController $cache */ $cache = self::getConfigCacheController(); $config = $cache->get( fn() => self::buildConfig(), [], 'config' ); return $config; } /** * Function to store the configuration settings in to Joomla configured cache * * @param array $config The config object to store. * * @return void * @since 7.0.0 */ private static function storeCachedConfig(array $config): void { /** @var CallbackController $cache */ $cache = self::getConfigCacheController(); $cache->store($config, 'config'); } /** * Function to get the Configuration cache Controller * * @return CacheController * @since 7.0.0 */ private static function getConfigCacheController(): CacheController { $options = [ 'defaultgroup' => self::COMPONENT . '_configuration', 'caching' => \true, // Force caching 'lifetime' => 5259600 // Config cache never expires ]; /** @var CallbackController $cache */ $cache = Factory::getContainer()->get(CacheControllerFactoryInterface::class)->createCacheController('callback', $options); return $cache; } /** * get the XML file * * @param string $path Path to the XML file * * @return SimpleXMLElement|false * @since 7.0.0 */ private static function getXml(string $path): \SimpleXMLElement|false { if (!\is_file($path)) { return \false; } $xml = new \SimpleXMLElement(\file_get_contents($path)); return $xml; } /** * Extract default values from config.xml using Joomla Form API * * @param string $path Path to the XML file * * @return array * @since 7.0.0 */ private static function getXmlDefaults(string $path): array { $xml = self::getXml($path); if (!$xml) { return []; } $defaults = []; // Assuming typical Joomla form XML structure:

// Adjust XPath if your config.xml structure is different. foreach ($xml->xpath('//field') as $field) { $attributes = $field->attributes(); $name = (string) ($attributes['name'] ?? ''); $type = (string) ($attributes['type'] ?? ''); $config = (string) ($attributes['config'] ?? ''); if ( !empty($name) && !\str_starts_with($name, '@') && $type !== 'spacer' && $config !== 'false' ) { $defaults[$name] = (string) ($attributes['default'] ?? ''); } } return $defaults; } /** * Print all properties on screen to create a docblock property list we can use in this class * * @param string $path Path to the XML file * * @return never * @since 7.0.0 */ public static function getIdeProperties(): never { $xml = self::getXml(JPATH_ADMINISTRATOR . '/components/' . self::COMPONENT . '/config.xml'); if (!$xml) { die('- nothing to list -'); } $properties = []; $params = ComponentHelper::getParams(self::COMPONENT); // Assuming typical Joomla form XML structure:

// Adjust XPath if your config.xml structure is different. foreach ($xml->xpath('//field') as $field) { $attributes = $field->attributes(); $name = (string) ($attributes['name'] ?? ''); $type = (string) ($attributes['type'] ?? ''); $config = (string) ($attributes['config'] ?? ''); if ( !empty($name) && !\str_starts_with($name, '@') && $type !== 'spacer' && $config !== 'false' ) { $type = \is_array($params->get($name, '')) ? 'array ' : 'string'; $label = Text::_((string) ($attributes['label'] ?? '')); $properties[$name] = ['label' => $label, 'type' => $type]; } } $maxLength = 0; foreach ($properties as $property => $value) { $length = \strlen($property . $value['type']); if ($length > $maxLength) { $maxLength = $length; } } // Ensure the array is sorted by key \ksort($properties); // Step 2: Iterate and pad the property key to align the label foreach ($properties as $property => $value) { // Pad the property key with spaces on the right side $paddedProperty = \str_pad($property, $maxLength); $label = $value['label']; $type = $value['type']; // Output the string, aligning the label echo " * @property $type \$$paddedProperty $label\r\n"; } die; } /** * Function to save a key value in the component configuration * * @return boolean * @since 7.0.0 */ public function save(): bool { $params = ComponentHelper::getParams(self::COMPONENT); foreach ($params as $key => $value) { if ($this->config[$key] === $value) { continue; } $params->set($key, $this->config[$key]); } /** @var DatabaseDriver $db */ $db = Factory::getContainer()->get(DatabaseInterface::class); $query = $db->createQuery() ->update($db->quoteName('#__extensions')) ->set($db->quoteName('params') . ' = ' . $db->quote(\json_encode($params))) ->where($db->quoteName('name') . ' = ' . $db->quote(self::COMPONENT)); $db->setQuery($query); $result = $db->execute(); // Clean out the Cache and start with new value(s) $this->reset(); return $result; } /** * Function to clear the local cached $config variable * * @return void * @since 7.0.0 */ public function reset(): void { $cache = self::getConfigCacheController(); // Clean the Kunena configuration cache and the _system cache as that is where Joomla itself caches the component cache $cache->clean(self::COMPONENT . '_configuration'); $cache->clean('_system'); self::$instance = \null; } }