V1.2.3

Max

Hello ici.

@petitpouyo l'a demandé, j'ai essayé de le faire : La version 1.2.3 est sortie, et apporte quelques nouveautés sur le module blog. Vous pouvez lire la news ici : https://299ko.ovh/blog/1-2-3-soleil-14.html

En revanche, j'ai constaté un soucis qui va générer une erreur avec le module blog.

Si vous avez déjà fait la mise à jour :

Allez sur votre serveur, et ouvrez le fichier plugins/configmanager/lib/UpdaterManager.php.
Remplacez tout le contenu par ça :

<?php

/**
 * @copyright (C) 2023, 299Ko
 * @license https://www.gnu.org/licenses/gpl-3.0.en.html GPLv3
 * @author Maxence Cauderlier <mx.koder@gmail.com>
 * 
 * @package 299Ko https://github.com/299Ko/299ko
 */
defined('ROOT') OR exit('No direct script access allowed');

class UpdaterManager {

    /**
     * Official last version, not future version
     * @var string
     */
    public $lastVersion;
    
    /**
     * Future version ready to install, depending actual version
     * @var string
     */
    public $nextVersion;
    
    /**
     * File `versions/main/core/versions.json` 
     * @var array
     */
    protected $metaDatas;

    /**
     * REMOTE is raw Github URL
     */
    const REMOTE = 'https://raw.githubusercontent.com/299Ko/';

    public function __construct() {
        if (!ini_get('allow_url_fopen')) {
            logg("Can't get remotes files", 'INFO');
            return false;
        }

        $fileContent = $this->getRemoteFileContent(self::REMOTE . 'versions/main/core/versions.json');

        if (!$fileContent) {
            return false;
        }

        $file = json_decode($fileContent, true);
        $this->lastVersion = $file['last_version'];

        $this->metaDatas = $file;
    }

    /**
     * Get the next version ready to install
     * @return mixed
     */
    public function getNextVersion() {
        if ($this->lastVersion > VERSION) {
            if (key_exists(VERSION, $this->metaDatas)) {
                return $this->metaDatas[VERSION];
            }
        }
        return false;
    }

    public function update() {
        $nextVersion = $this->getNextVersion();
        if ($nextVersion === false) {
            return false;
        }
        
        $rawFiles = $this->getRemoteFileContent(self::REMOTE . 'versions/main/core/' . $nextVersion . '/files.json', 'ERROR');
        if ($rawFiles === false) {
            return false;
        }
        $files = json_decode($rawFiles, true);
        
        logg("Begin update to v$nextVersion", 'INFO');
        $this->runBeforeChangeFiles($nextVersion);
        foreach ($files['M'] as $fileArray) {
            $this->processModify($fileArray, $nextVersion);
        }
        foreach ($files['A'] as $fileArray) {
            $this->processAdd($fileArray, $nextVersion);
        }
        foreach ($files['D'] as $fileArray) {
            $this->processDelete($fileArray, $nextVersion);
        }
        $this->runAfterChangeFiles($nextVersion);
        logg("End update to v$nextVersion", 'INFO');
    }

    protected function rewritePathFile($filename, $ignoreExist = false) {
        if (substr($filename, 0, 7) === 'plugin/') {
            return $this->treatPlugin($filename, $ignoreExist);
        } elseif (substr($filename, 0, 6) === 'theme/') {
            return $this->treatTheme($filename);
        } elseif (substr($filename, 0, 5) === 'core/') {
            return $this->treatCore($filename);
        } elseif (substr($filename, 0, 7) === 'common/') {
            return $this->treatCommon($filename);
        } else {
            return ROOT . $filename;
        }
    }

    protected function getRemoteFile($filename, $version) {
        return self::REMOTE . '299ko/v' . $version . '/' . $filename;
    }

    protected function treatPlugin($filename, $ignoreExist) {
        preg_match('/^plugin\/(\w+)\/(.*)$/i', $filename, $matches);
        $plugin = $matches[1];
        if (is_dir(PLUGINS . $plugin) === false && $ignoreExist === false) {
            // plugin is not installed, no treatment
            return false;
        }
        return PLUGINS . $plugin . '/' . $matches[2];
    }
    
    protected function treatTheme($filename) {
        preg_match('/^theme\/(.*)$/i', $filename, $matches);
        return THEMES . $matches[1];
    }
    
    protected function treatCore($filename) {
        preg_match('/^core\/(.*)$/i', $filename, $matches);
        return CORE . $matches[1];
    }
    
    protected function treatCommon($filename) {
        preg_match('/^common\/(.*)$/i', $filename, $matches);
        return COMMON . $matches[1];
    }


    protected function processModify($file, $version) {
        $localFileName = $this->rewritePathFile($file);
        if ($localFileName === false) {
            return;
        }
        $remoteFile = $this->getRemoteFile($file, $version);
        $content = $this->getRemoteFileContent($remoteFile, 'ERROR');
        if ($content === false) {
            // Remote file dont exist
            return;
        }
        $this->createDirectories($localFileName);
        if (@file_put_contents($localFileName, $content, LOCK_EX)) {
            logg("$localFileName was modified", 'INFO');
            return true;
        }
        logg("unable to write $localFileName", 'ERROR');
        return false;
    }
    
    protected function processAdd($file, $version) {
        $localFileName = $this->rewritePathFile($file, true);
        $remoteFile = $this->getRemoteFile($file, $version);
        $content = $this->getRemoteFileContent($remoteFile, 'ERROR');
        if ($content === false) {
            // Remote file dont exist
            return;
        }
        $this->createDirectories($localFileName);
        if (@file_put_contents($localFileName, $content, LOCK_EX)) {
            logg("file $localFileName Added");
            return true;
        }
        logg("unable to write $localFileName", 'ERROR');
        return false;
    }
    
    protected function processDelete($file) {
        $localFileName = $this->rewritePathFile($file);
        if ($localFileName === false) {
            return;
        }
        if (@unlink($localFileName)) {
            logg("file $localFileName Deleted");
            $this->deleteEmptydirectory($localFileName);
            return true;
        }
        logg("unable to delete $localFileName", 'ERROR');
        return false;
    }
    
    /**
     * Create nested directories for a file, with full relative path
     * @param string Path File
     */
    protected function createDirectories($pathFile) {
        $arrPath = explode('/', $pathFile);
        array_pop($arrPath);
        $path = '';
        foreach ($arrPath as $dir) {
            $path .= $dir . '/';
        }
        if (!is_dir($path)) {
            if (mkdir($path, 0775, true)) {
                logg("$path folder has been created");
            } else {
                logg("Impossible to create $path directory", 'ERROR');
            }
        }
    }
    
    /**
     * Delete Folder from a file path, if folder is empty
     * @param string Path File
     */
    protected function deleteEmptydirectory($pathFile) {
        $arrPath = explode('/', $pathFile);
        array_pop($arrPath);
        $path = '';
        foreach ($arrPath as $dir) {
            $path .= $dir . '/';
        }
        if (is_dir($path) && !(new \FilesystemIterator($path))->valid()) {
            if (rmdir($path)) {
                logg("$path (empty folder) has been deleted");
            } else {
                logg("Impossible to delete $path directory", 'ERROR');
            }
        }
    }

    /**
     * Get the content of a remote file by its URL
     * Log if file is not found
     * 
     * @param string File URL
     * @param string Severity Log message
     * @return mixed Content or false
     */
    protected function getRemoteFileContent($remoteFileUrl, $severity = 'INFO') {
        $headers = get_headers($remoteFileUrl);
        if (strpos($headers[0], '404') !== false) {
            logg("Remote file $remoteFileUrl dont exist", $severity);
            return false;
        }
        $handle = @fopen($remoteFileUrl, 'r');
        // Check if file exists
        if (!$handle) {
            logg("Cant open $remoteFileUrl", $severity);
            return false;
        } else {
            $content = stream_get_contents($handle);
            fclose($handle);
        }
        if ($content === '404: Not Found') {
            // Github file dont exist
            logg("Remote file $remoteFileUrl dont exist", $severity);
            return false;
        }
        return $content;
    }
    
    protected function runBeforeChangeFiles($nextVersion) {
        $remoteFile = self::REMOTE . 'versions/main/core/' . $nextVersion .'/_beforeChangeFiles.php';
        $content = $this->getRemoteFileContent($remoteFile);
        if ($content === false) {
            // No script to run before change files
            return;
        }
        $tmpFile = PLUGINS . 'configmanager' . '/tmp_beforeChangeFiles.php';
        if (@file_put_contents($tmpFile, $content, LOCK_EX)) {
            require_once $tmpFile;
            @unlink($tmpFile);
            return true;
        }
        return false;
    }
    
    protected function runAfterChangeFiles($nextVersion) {
        $remoteFile = self::REMOTE . 'versions/main/core/' . $nextVersion .'/_afterChangeFiles.php';
        $content = $this->getRemoteFileContent($remoteFile);
        if ($content === false) {
            // No script to run before change files
            return;
        }
        $tmpFile = PLUGINS . 'configmanager' . '/tmp_afterChangeFiles.php';
        if (@file_put_contents($tmpFile, $content, LOCK_EX)) {
            require_once $tmpFile;
            @unlink($tmpFile);
            return true;
        }
        return false;
    }

}

Enregistrez, et ouvrez le fichier 'data/config.php'.
Modifiez la ligne suivante :

define('VERSION', '1.2.3');

En remplacant '1.2.3 par '1.2.2.
Sauvegardez, et 299Ko vous proposera d'effectuer à nouveau la mise à jour vers la 1.2.3.
Faites la mise à jour et la soucis devrait être réglé.

Si vous n'avez pas encore fait la mise à jour

Allez sur votre serveur, et ouvrez le fichier plugins/configmanager/lib/UpdaterManager.php.
Remplacez tout le contenu par ça :

<?php

/**
 * @copyright (C) 2023, 299Ko
 * @license https://www.gnu.org/licenses/gpl-3.0.en.html GPLv3
 * @author Maxence Cauderlier <mx.koder@gmail.com>
 * 
 * @package 299Ko https://github.com/299Ko/299ko
 */
defined('ROOT') OR exit('No direct script access allowed');

class UpdaterManager {

    /**
     * Official last version, not future version
     * @var string
     */
    public $lastVersion;
    
    /**
     * Future version ready to install, depending actual version
     * @var string
     */
    public $nextVersion;
    
    /**
     * File `versions/main/core/versions.json` 
     * @var array
     */
    protected $metaDatas;

    /**
     * REMOTE is raw Github URL
     */
    const REMOTE = 'https://raw.githubusercontent.com/299Ko/';

    public function __construct() {
        if (!ini_get('allow_url_fopen')) {
            logg("Can't get remotes files", 'INFO');
            return false;
        }

        $fileContent = $this->getRemoteFileContent(self::REMOTE . 'versions/main/core/versions.json');

        if (!$fileContent) {
            return false;
        }

        $file = json_decode($fileContent, true);
        $this->lastVersion = $file['last_version'];

        $this->metaDatas = $file;
    }

    /**
     * Get the next version ready to install
     * @return mixed
     */
    public function getNextVersion() {
        if ($this->lastVersion > VERSION) {
            if (key_exists(VERSION, $this->metaDatas)) {
                return $this->metaDatas[VERSION];
            }
        }
        return false;
    }

    public function update() {
        $nextVersion = $this->getNextVersion();
        if ($nextVersion === false) {
            return false;
        }
        
        $rawFiles = $this->getRemoteFileContent(self::REMOTE . 'versions/main/core/' . $nextVersion . '/files.json', 'ERROR');
        if ($rawFiles === false) {
            return false;
        }
        $files = json_decode($rawFiles, true);
        
        logg("Begin update to v$nextVersion", 'INFO');
        $this->runBeforeChangeFiles($nextVersion);
        foreach ($files['M'] as $fileArray) {
            $this->processModify($fileArray, $nextVersion);
        }
        foreach ($files['A'] as $fileArray) {
            $this->processAdd($fileArray, $nextVersion);
        }
        foreach ($files['D'] as $fileArray) {
            $this->processDelete($fileArray, $nextVersion);
        }
        $this->runAfterChangeFiles($nextVersion);
        logg("End update to v$nextVersion", 'INFO');
    }

    protected function rewritePathFile($filename, $ignoreExist = false) {
        if (substr($filename, 0, 7) === 'plugin/') {
            return $this->treatPlugin($filename, $ignoreExist);
        } elseif (substr($filename, 0, 6) === 'theme/') {
            return $this->treatTheme($filename);
        } elseif (substr($filename, 0, 5) === 'core/') {
            return $this->treatCore($filename);
        } elseif (substr($filename, 0, 7) === 'common/') {
            return $this->treatCommon($filename);
        } else {
            return ROOT . $filename;
        }
    }

    protected function getRemoteFile($filename, $version) {
        return self::REMOTE . '299ko/v' . $version . '/' . $filename;
    }

    protected function treatPlugin($filename, $ignoreExist) {
        preg_match('/^plugin\/(\w+)\/(.*)$/i', $filename, $matches);
        $plugin = $matches[1];
        if (is_dir(PLUGINS . $plugin) === false && $ignoreExist === false) {
            // plugin is not installed, no treatment
            return false;
        }
        return PLUGINS . $plugin . '/' . $matches[2];
    }
    
    protected function treatTheme($filename) {
        preg_match('/^theme\/(.*)$/i', $filename, $matches);
        return THEMES . $matches[1];
    }
    
    protected function treatCore($filename) {
        preg_match('/^core\/(.*)$/i', $filename, $matches);
        return CORE . $matches[1];
    }
    
    protected function treatCommon($filename) {
        preg_match('/^common\/(.*)$/i', $filename, $matches);
        return COMMON . $matches[1];
    }


    protected function processModify($file, $version) {
        $localFileName = $this->rewritePathFile($file);
        if ($localFileName === false) {
            return;
        }
        $remoteFile = $this->getRemoteFile($file, $version);
        $content = $this->getRemoteFileContent($remoteFile, 'ERROR');
        if ($content === false) {
            // Remote file dont exist
            return;
        }
        $this->createDirectories($localFileName);
        if (@file_put_contents($localFileName, $content, LOCK_EX)) {
            logg("$localFileName was modified", 'INFO');
            return true;
        }
        logg("unable to write $localFileName", 'ERROR');
        return false;
    }
    
    protected function processAdd($file, $version) {
        $localFileName = $this->rewritePathFile($file, true);
        $remoteFile = $this->getRemoteFile($file, $version);
        $content = $this->getRemoteFileContent($remoteFile, 'ERROR');
        if ($content === false) {
            // Remote file dont exist
            return;
        }
        $this->createDirectories($localFileName);
        if (@file_put_contents($localFileName, $content, LOCK_EX)) {
            logg("file $localFileName Added");
            return true;
        }
        logg("unable to write $localFileName", 'ERROR');
        return false;
    }
    
    protected function processDelete($file) {
        $localFileName = $this->rewritePathFile($file);
        if ($localFileName === false) {
            return;
        }
        if (@unlink($localFileName)) {
            logg("file $localFileName Deleted");
            $this->deleteEmptydirectory($localFileName);
            return true;
        }
        logg("unable to delete $localFileName", 'ERROR');
        return false;
    }
    
    /**
     * Create nested directories for a file, with full relative path
     * @param string Path File
     */
    protected function createDirectories($pathFile) {
        $arrPath = explode('/', $pathFile);
        array_pop($arrPath);
        $path = '';
        foreach ($arrPath as $dir) {
            $path .= $dir . '/';
        }
        if (!is_dir($path)) {
            if (mkdir($path, 0775, true)) {
                logg("$path folder has been created");
            } else {
                logg("Impossible to create $path directory", 'ERROR');
            }
        }
    }
    
    /**
     * Delete Folder from a file path, if folder is empty
     * @param string Path File
     */
    protected function deleteEmptydirectory($pathFile) {
        $arrPath = explode('/', $pathFile);
        array_pop($arrPath);
        $path = '';
        foreach ($arrPath as $dir) {
            $path .= $dir . '/';
        }
        if (is_dir($path) && !(new \FilesystemIterator($path))->valid()) {
            if (rmdir($path)) {
                logg("$path (empty folder) has been deleted");
            } else {
                logg("Impossible to delete $path directory", 'ERROR');
            }
        }
    }

    /**
     * Get the content of a remote file by its URL
     * Log if file is not found
     * 
     * @param string File URL
     * @param string Severity Log message
     * @return mixed Content or false
     */
    protected function getRemoteFileContent($remoteFileUrl, $severity = 'INFO') {
        $headers = get_headers($remoteFileUrl);
        if (strpos($headers[0], '404') !== false) {
            logg("Remote file $remoteFileUrl dont exist", $severity);
            return false;
        }
        $handle = @fopen($remoteFileUrl, 'r');
        // Check if file exists
        if (!$handle) {
            logg("Cant open $remoteFileUrl", $severity);
            return false;
        } else {
            $content = stream_get_contents($handle);
            fclose($handle);
        }
        if ($content === '404: Not Found') {
            // Github file dont exist
            logg("Remote file $remoteFileUrl dont exist", $severity);
            return false;
        }
        return $content;
    }
    
    protected function runBeforeChangeFiles($nextVersion) {
        $remoteFile = self::REMOTE . 'versions/main/core/' . $nextVersion .'/_beforeChangeFiles.php';
        $content = $this->getRemoteFileContent($remoteFile);
        if ($content === false) {
            // No script to run before change files
            return;
        }
        $tmpFile = PLUGINS . 'configmanager' . '/tmp_beforeChangeFiles.php';
        if (@file_put_contents($tmpFile, $content, LOCK_EX)) {
            require_once $tmpFile;
            @unlink($tmpFile);
            return true;
        }
        return false;
    }
    
    protected function runAfterChangeFiles($nextVersion) {
        $remoteFile = self::REMOTE . 'versions/main/core/' . $nextVersion .'/_afterChangeFiles.php';
        $content = $this->getRemoteFileContent($remoteFile);
        if ($content === false) {
            // No script to run before change files
            return;
        }
        $tmpFile = PLUGINS . 'configmanager' . '/tmp_afterChangeFiles.php';
        if (@file_put_contents($tmpFile, $content, LOCK_EX)) {
            require_once $tmpFile;
            @unlink($tmpFile);
            return true;
        }
        return false;
    }

}

Enregistrez, et vous pouvez faire la mise à jour.

Désolé pour ce petit désagrément.

Max

Je vais publier une version 1.2.4 d'ici peu. Si vous pouvez attendre, ne faites rien, la V1.2.4 résoudra le soucis de la config du blog de la 1.2.3 sans aucune action de votre part.

petitpouyo

Salut je viens de faire la 1.2.3 puis à la suite la 1.2.4... l'onglet blog a disparu comme par enchantement 🤧
Rien de grave il suffit de se rendre dans Pages & Menu, créer un lien externe qu'on nommera "Blog" et coller l'adresse web suivante: https://monsupersite299ko.fr/blog/

On sauvegarde et tout redevient à la "normale" provisoirement ! 🤓

Max

petitpouyo Est-ce que tu peux me coller le contenu du fichier data/logs.txt stp vieux ?

Normalement la 1.2.4 aurait dû résoudre ce soucis de menu aussi, j'aimerais savoir pourquoi ça n'a pas fonctionné.

petitpouyo

Max c'est fait sur le ticket staff

Max

petitpouyo
Merci pour ton retour, je crois que j'ai compris.
Est-ce que tu peux modifier ton fichier common/config.php, pour redéfinir la version en '1.2.3' et réessayer la mise à jour vers la 1.2.4 stp ?
Si il te dit qu'il n'y a pas de nouvelle version, il faut supprimer le fichier data/plugins/configmanager/cache.json
Ça devrait fonctionner après, je crois que j'ai compris : J'ai modifié un fichier, mais comme il était déjà chargé en RAM par le script, il n'a pas pris en compte les modifs, et du coup il n'a pas fait les changements de la config du blog.

Je te remercie 😉

claireomatic

Bonjour,

De passage par hasard pour voir les nouveautés, je constate qu'il y en a !
Donc là on peut faire la mise à jour vers la 1.2.4, le problème rencontré par petitpouyo ne devrait pas se produire ? Ou il vaut mieux attendre ?

Dans le doute, je n'ai pas fait de mise à jour pour l'instant, mais j'ai été lire l'article de présentation, voici mon avis :

La fonctionnalité "introduction" des articles de blog me semble très intéressante.
Ton idée pour l'aide des plugins dans des bulles me semble très bien.
pour les onglets, je pense que c'est peut-être bien pour des gens "à l'aise", mais pas forcément pour des grands débutants : Quand on découvre 299ko, le fait qu'il n'y ait pas des endroits où cliquer partout, qu'on voie tout tout de suite, c'est très rassurant ; on sent que c'est simple. Aussi, c'est bien pratique de toujours voir le contenu de l'onglet "Paramètres", pour se rendre compte qu'une page est publiée ou ne l'est pas si c'est une erreur. (petite anecdote : après avoir fait plein de tests sur mon site de test, j'ai décidé de copier le vrai site vers le site de test, pour revenir sur une base de travail propre. J'ai bien pensé à modifier l'URL du site, mais au début j'ai oublié d'interdire l'indexation. Heureusement que cette info était visible sans que je la cherche !)
Le bouton "enregistrer" flottant est une très bonne idée car c'est vrai que souvent il fallait aller le chercher loin. Par contre je suis moins enthousiaste sur le fait qu'il ne comporte qu'un icone : quand on est peu à l'aise en informatique, le mot "enregistrer" est beaucoup plus clair.

Max

claireomatic

Hello Claire.
Si tu fais la mise à jour, tu devras faire la manip que j'ai donné à @petitpouyo
Sinon, tu peux attendre la prochaine version qui devrait sortir dans quelques jours, et qui fixera définitivement le soucis.
La prochaine version mineure implémentera une autre fonctionnalité pour le blog : Celle de pouvoir donner des infos pour les réseaux sociaux, afin de partager plus facilement vos nouvelles (avec image, description etc)
Pour la prochaine version majeure, la 1.3, je suis en train de modifier le cœur du CMS pour le rendre disponible dans d'autres langues, afin de toucher un public plus large.
Mais avant la 1.3, je me mettrais sur la Doc, parce qu'il faut vraiment que je le fasse.

Si quelqu'un veut participer à quelque chose, qu'il me fasse signe. Il n'y a pas besoin savoir coder, nii pour traduire 299Ko, ni pour faire de la documentation, il faut juste du temps, ressource la plus rare en général 🙂

Merci pour ton retour

claireomatic

Ok merci, je vais attendre la version suivante.
Je suis désolée, mais je ne suis pas assez geek pour consacrer plus de temps à 299ko... :-(

Max

claireomatic

Tu peux faire la mise à jour, la 1.2.5 est sortie. Je fais une news plus tard.

petitpouyo

Max TOP DU TOP !!

OpenGraph pour les réseaux sociaux dans un article de blog
Socials Description dans l'article de blog
Ajouter un bouton pour actualiser le cache dans le plugin configManager
Ajouter func (show class) pour afficher des métas personnalisées