PHPCG est un CRUD Generator développé en PHP pur pour construire votre panneau d'administration Bootstrap à l'aide d'une interface visuelle UI.
PHPCG convient aussi bien aux non-programmeurs qu'aux programmeurs PHP avancés, qui auront accès à un code propre et bien organisé afin de pouvoir tirer parti de tout son potentiel.
PHPCG est capable d'analyser votre base de données et d'extraire les tables, les champs et tout type de relation de manière intelligente.
Le moteur CRUD est basé sur PHP PDO et prend entièrement en charge les systèmes de gestion de bases de données relationnelles (SGBDR) suivants :
MySQL
MariaDB
Oracle
Firebird
PostgreSQL
Vous pouvez ensuite utiliser les données de base de données analysées pour générer votre panneau d'administration utilisateur :
Listes paginées (CRUD READ)
filtrage des enregistrements, y compris avec les tables relationnelles internes/externes
tri
édition avancée sur place (texte, select, booléen, date et heure,...)
tables imbriquées
tables de données externes (relations externes)
export aux formats Excel/CSV/PDF/PRINT
Formulaires Créer & Mettre à jour (CRUD CREATE/UPDATE)
formulaires construits avec PHP Form Builder, reconnu pour sa robustesse et sa fiabilité
Tous les types de champs
Intégration automatique des meilleurs plugins jQuery pour améliorer l'expérience utilisateur (select & radio personnalisés, éditeur de texte enrichi, téléverseur de fichiers, sélecteurs, ...)
listes déroulantes avec un contenu intelligent et personnalisable
téléversement de fichiers/images avec recadrage/redimensionnement et génération de vignettes personnalisable
validation automatique selon le type de données personnalisables
mise en page efficace et simple - Possibilité de regrouper les champs en 2 et 3 colonnes
Formulaires de suppression (CRUD DELETE)
Suppression en cascade des enregistrements dépendants
Affichage du nombre d'enregistrements dépendants qui seront supprimés
Conseils rapides
Voici une courte vidéo de présentation qui montre comment fonctionne PHP CRUD Generator de A à Z.
Pour créer votre base de données relationnelle, nous vous recommandons de consulter :
PHP 8.1+ avec le pilote PDO, les extensions mb_string et curl activées. L'extension PHP curl doit être autorisée à envoyer des requêtes au serveur de licences.
db-connect.php Paramètres de connexion PDO — contient les paramètres de connexion de jusqu'à 2 serveurs, sélectionnés automatiquement pour le serveur actuel ; peut être synchronisé entre les serveurs
vendor* Fichiers vendor de Composer (moteur de modèles Twig, Monolog, composants Symfony, ...)
Légende :
*
Requis sur votre serveur de production
Démarrage rapide
À propos du flux de travail local et de production
Le dossier "generator" n'est requis que pour construire et modifier votre panneau d'administration Bootstrap.
Si vous utilisez un serveur local + un serveur distant ("serveur de production") : Vous pouvez soit :
utiliser le générateur local pour créer votre panneau d'administration, puis téléverser les dossiers "admin" et "conf" sur votre serveur distant.
créer le panneau d'administration directement depuis votre serveur de production.
La 2e méthode est celle recommandée.
Si vous n'utilisez pas de serveur local : Téléversez tous les dossiers requis et construisez votre tableau de bord d'administration CRUD directement depuis le générateur distant.
Téléversez les dossiers requis* sur votre serveur comme décrit dans la section "structure du package".
Si vous installez PHP CRUD Generator dans un sous-dossier
(en d'autres termes, si le admin, classe, conf, generator, ... les dossiers ne sont pas à la racine de votre projet), vous devez modifier admin/.htaccess pour éviter les erreurs 404 :
ouvrez /admin/.htaccess dans votre éditeur de code
ajoutez votre sous-dossier au RewriteRule. Par exemple : RewriteRule . /your-folder/admin/index.php [QSA,L]
2
Ouvrez l'installateur - /install/index.php - dans votre navigateur et suivez l'assistant : L'étape 1 vérifie votre serveur (prérequis) et enregistre votre licence ; l'étape 2 enregistre votre connexion à la base de données ; l'étape 3 définit les informations générales essentielles (nom du projet, logo, ...). Si vous utilisez un serveur local + un serveur distant, vous devez exécuter l'installateur sur les deux. Plus d'informations disponibles dans le Installation/Enregistrement section
3
Tout est maintenant prêt pour générer votre panneau d'administration à l'aide du CRUD Generator.
Ouvrez le générateur - /generator/generator.php - dans votre navigateur.
Installation/Enregistrement
Si vous utilisez un serveur local + un serveur distant, vous devez exécuter l'installateur sur les deux: chaque serveur enregistre ses propres paramètres de connexion et sa propre activation de licence.
Que fait l'installateur ?
L'installateur :
Teste la compatibilité de votre serveur (version PHP, modules disponibles, droits d'écriture, ...)
Vérifie et enregistre votre licence
Enregistre vos identifiants de connexion à la base de données pour le serveur actuel dans class/database/db-connect.php
Définit les informations générales essentielles (nom du projet, logo, ...)
Un fichier de connexion, jusqu'à deux serveurs
class/database/db-connect.php contient les paramètres de connexion de jusqu'à 2 serveurs différents (par exemple votre serveur de développement local et votre serveur de production). Le programme calcule une empreinte de serveur à partir du nom d'hôte de la machine et du chemin d'installation, et utilise automatiquement les paramètres enregistrés pour le serveur sur lequel il s'exécute.
Ce fichier peut donc être synchronisé entre vos serveurs sans risque.
Il n'y a aucun repli: si le serveur actuel n'a aucune connexion enregistrée (installation déplacée, dossier renommé, conteneur reconstruit, nouveau déploiement, ...), l'application s'arrête sur un écran Connexion à la base de données requise qui renvoie vers l'installateur. L'exécution de l'installateur sur ce serveur préremplit les paramètres existants et enregistre le serveur actuel - rien n'est supprimé.
Si vous rencontrez une erreur
Comme pour tout programme PHP, vous pouvez rencontrer des problèmes lors de l'installation ou du premier démarrage. Cela ne signifie pas que le programme est défectueux, mais plutôt que vous devez configurer correctement votre serveur pour l'utiliser.
Si cela se produit :
Tout d'abord, vérifiez que votre serveur répond aux prérequis (version PHP, réécriture activée, ...)
Ne modifiez rien ici, sauf si vous savez ce que vous faites.
Configuration USER (Paramètres généraux)
Ce fichier contient certains paramètres globaux pouvant être personnalisés
Pour modifier ces paramètres, ouvrez le Generator dans votre navigateur et cliquez sur l'onglet Configuration .
Projet
Nom du site web
Le nom de votre projet affiché dans l'en-tête du tableau de bord d'administration.
Logo de l'administration
Le logo de votre projet affiché dans l'en-tête du tableau de bord d'administration.
Sécurité
Verrouiller le Generator
Permet de verrouiller/déverrouiller l'accès au générateur. Si le générateur est verrouillé, l'accès est protégé par une page d'identification. Vous devrez saisir votre email et votre clé de licence pour y accéder.
Licence
Statut de la licence
Carte en lecture seule affichant l'état de votre licence : un badge d'activation (Activée avec date, ou Non activée), votre clé de licence masquée, l'email d'enregistrement, le domaine sous licence, et un raccourci vers votre portail client Polar pour gérer les activations. La carte lit uniquement l'enregistrement local de la licence — l'activation et l'auto-réparation sont gérées par install/do-install.php.
Débogage
Activer le débogage
Choisissez « Oui » pour afficher les détails lorsqu'une requête de base de données rencontre une erreur, ainsi que les messages d'exception et les informations d'erreur étendues.
Simuler et déboguer
Si activé, toutes les requêtes d'insertion/mise à jour/suppression seront simulées (NON exécutées), et les détails de toutes les requêtes de base de données seront affichés à l'écran.
Surveillance des erreurs PHP
Activer la surveillance des ERREURS PHP
choisissez « Oui » pour activer la surveillance des erreurs PHP et recevoir un email chaque fois qu'une erreur se produit dans le panneau d'administration.
L'adresse email (s) à laquelle (auxquelles) vous souhaitez que les erreurs soient envoyées.
Styles
Thème Bootstrap
Sélectionnez l'un des nombreux thèmes disponibles dans la liste déroulante.
Style de la barre de navigation
Style du menu de navigation supérieur du tableau de bord d'administration.
Style de la barre latérale
Style de la barre latérale du tableau de bord d'administration.
Classe CSS des colonnes filtrées
Dans le tableau de bord d'administration, les colonnes filtrées sont marquées avec un style spécifique de votre choix. Vous pouvez ici saisir une classe CSS Bootstrap et ajuster l'opacité. Par exemple : bg-danger bg-opacity-10
Style des sélecteurs de date et d'heure
Style des sélecteurs de date et d'heure (« Default » ou « Material Design »).
Classe des boutons par défaut
Classe CSS Bootstrap pour les boutons secondaires du panneau d'administration. Par exemple : text-bg-light
Arrière-plan par défaut des en-têtes de tableau
Classe CSS Bootstrap pour les en-têtes de tableaux du panneau d'administration. Par exemple : text-bg-dark
Interface utilisateur (UI)
Position des boutons d'ACTION d'administration
Choisissez si vous souhaitez afficher les boutons d'édition d'enregistrement (voir/éditer/supprimer) à gauche ou à droite dans les listes READ de l'administration.
Activer la possibilité de changer les styles depuis le tableau de bord d'administration
Si activé, chaque utilisateur peut choisir les couleurs de son thème et de sa barre de navigation. Ses préférences sont stockées dans le navigateur et n'affectent pas les autres utilisateurs.
Activer les filtres
Lorsqu'un utilisateur du panneau d'administration définit un filtre, celui-ci peut être appliqué immédiatement, ou après un clic sur le bouton "filtrer", comme vous le souhaitez.
Réduire les catégories inactives de la barre latérale
Choisissez si vous souhaitez que la barre latérale d'administration se comporte comme un menu accordéon ou si plusieurs catégories peuvent rester dépliées en même temps.
Affichage des tableaux de données
Choisissez si vous souhaitez afficher les données du tableau dans la partie visible de la page avec une barre de défilement interne, ou dans un tableau de hauteur illimitée utilisant la barre de défilement du navigateur.
Affichage des résultats de recherche
Affichez tous les résultats de recherche sur la même page, ou en utilisant des résultats paginés.
Contrainte de mot de passe pour les nouveaux comptes utilisateurs
Choisissez le niveau de sécurité minimum pour les mots de passe des utilisateurs de l'administration.
Paramètres de langue
Langue
La langue principale du tableau de bord d'administration.
Traduction de la date/heure pour les listes d'administration
Définit le PHP Locale::setDefault pour traduire automatiquement les dates PHP
Fuseau horaire
Votre fuseau horaire
Langue des sélecteurs de date et d'heure
Les langues disponibles se trouvent dans class/phpformbuilder/plugins/pickadate/lib/compressed/translations/
Langue de validation des formulaires en direct (JavaScript)
Les langues disponibles se trouvent dans class/phpformbuilder/plugins/formvalidation/js/locales
Langue de validation des formulaires côté serveur (PHP)
Protéger l'accès au Générateur avec une page de connexion
Pour protéger l'accès au générateur :
Ouvrez le Générateur - generator/generator.php - dans votre navigateur
Ouvrez l' Configuration onglet
Définir Lock the Generator à Oui
Terminé - lorsque vous ouvrez generator/generator.php dans votre navigateur. Vous serez redirigé vers la page de connexion. Entrez votre email d'enregistrement et votre clé de licence pour vous connecter.
Panneau principal
Lorsque vous ouvrez le CRUD Generator, l'application vous donne accès à toutes ses fonctionnalités principales.
Choisissez la table que vous souhaitez configurer, puis cliquez sur l'un des trois boutons disponibles pour créer ou modifier votre administration Lire Liste, Créer/Mettre à jour Formulaires ou Supprimer Formulaire pour la table choisie.
Depuis cet onglet, vous pouvez définir tout ce dont vous avez besoin pour générer la liste de lecture de la table sélectionnée. Pour plus d'informations, veuillez consulter ce tutoriel, qui montre étape par étape comment créer les listes de lecture de votre tableau de bord d'administration.
Filtres de listes
Cliquez sur le bouton "Ajouter un filtre" dans le formulaire du générateur de listes de lecture pour ajouter un nouveau filtre.
Il ajoutera un nouveau filtre à votre liste.
PHPCG vous propose deux types de filtres :
Filtres simples
Vous n'avez qu'à choisir le champ à filtrer dans la liste déroulante.
Filtres avancés
Les filtres avancés sont utiles :
si vous souhaitez afficher deux valeurs ou plus dans la liste déroulante d'administration. par exemple, le prénom et le nom sont affichés, et la valeur filtrée est l'ID.
si vous souhaitez filtrer des valeurs provenant de relations externes.
Pour utiliser les filtres avancés, il est nécessaire de saisir des paramètres de requête avec des jointures.
Un bouton d'aide est disponible pour vous aider à construire votre requête, ainsi qu'un bouton d'aperçu qui vous permet de visualiser la liste déroulante générée et d'en vérifier la validité.
Vous pouvez choisir le thème Bootstrap et les couleurs de la barre de navigation depuis l'onglet Configuration du CRUD Generator.
Chaque utilisateur du tableau de bord admin peut ensuite choisir individuellement, depuis l'admin et selon ses préférences, son thème et ses couleurs préférés, qui ne seront appliqués que dans son propre navigateur (stockés sous forme de cookies).
Thèmes Bootstrap & CSS
Si vous êtes développeur et utilisez Gulp + SASS, les fichiers sources sont disponibles, prêts à l'emploi et bien organisés :
SASS utilisateurs : toutes les sources SASS sont disponibles
Module d'authentification des utilisateurs de l'administration
Installation du module d'authentification des utilisateurs admin
Le programme d'installation du module d'authentification des utilisateurs vous permet de configurer les droits d'accès aux éléments de l'admin. Il doit donc être installé en dernier, après avoir créé tous les éléments du CRUD.
Ouvrez le générateur dans votre navigateur, puis cliquez sur l'onglet "Module d'authentification".
Le programme d'installation créera les tables users et users_profiles tableaux
Vous devrez également saisir les informations de l'administrateur principal.
L'administrateur principal pourra ensuite gérer les utilisateurs et les profils dans le panneau d'administration.
Réinstaller/Mettre à jour le module d'authentification des utilisateurs admin
Si vous ajoutez des tables à votre panneau d'administration après avoir installé le module d'authentification des utilisateurs, vous devrez mettre à jour la table users_profiles .
À cette fin, vous avez deux possibilités :
1 - réinstaller avec le programme d'installation automatique
Désactiver le module depuis le générateur
Désinstaller le module depuis le générateur
Supprimer admin/secure/install/install.lock de votre serveur
Supprimez la table "users" et la table "users_profiles" de votre base de données.
Relancez le programme d'installation et suivez le processus
2 - Mettre à jour avec une simple requête SQL
Lorsque vous installez/réinstallez le module d'authentification, le users_profiles table utilisée par PHP CRUD Generator pour gérer les droits des utilisateurs est modifiée. Pour chaque table de votre base de données utilisée dans le panneau d'administration, quatre champs sont créés :
read_table
update_table
create_delete_table
constraint_query_table
Au lieu d'utiliser l'installateur automatique, vous pouvez ajouter les quatre champs avec une simple requête MySQL. Le résultat sera exactement le même qu'en utilisant l'installateur.
Copiez / collez la requête ci-dessous dans votre interface de gestion de base de données (ex : phpmyadmin) pour ajouter les quatre champs à la users_profiles .
Remplacez users_profiles par votre users_profiles nom de table, qui peut comporter un préfixe.
Remplacez _table par le nom de la table que vous souhaitez ajouter au module d'authentification.
ALTER TABLE `users_profiles`
ADD `r_table` BOOLEAN NOT NULL DEFAULT TRUE AFTER `profile_name`,
ADD `u_table` BOOLEAN NOT NULL DEFAULT TRUE AFTER `r_table`,
ADD `cd_table` BOOLEAN NOT NULL DEFAULT TRUE AFTER `u_table`,
ADD `cq_table` VARCHAR(255) NULL DEFAULT '' AFTER `cd_table`;
Toutes les opérations sont effectuées dans le même fichier :
Protégé par le module d'authentification des utilisateurs et de gestion des droits
Récupérer les enregistrements pour préremplir le formulaire
Créer et afficher le formulaire, y compris tous les plugins (listes déroulantes, sélecteurs, uploaders, ...)
Validation PHP
Mettre à jour les enregistrements de la base de données ou afficher les erreurs si des valeurs incorrectes sont envoyées
<?php
use phpformbuilder\Form;
use phpformbuilder\Validator\Validator;
use Migliori\PowerLitePdo\Db;
use common\Utils;
use secure\Secure;
include_once ADMIN_DIR . 'secure/class/secure/Secure.php';
$debug_content = '';
/* =============================================
validation if posted
============================================= */
if ($_SERVER["REQUEST_METHOD"] == "POST" && Form::testToken('form-edit-actor') === true) {
$validator = Form::validate('form-edit-actor', FORMVALIDATION_PHP_LANG);
$validator->required()->validate('first_name');
$validator->maxLength(45)->validate('first_name');
$validator->required()->validate('last_name');
$validator->maxLength(45)->validate('last_name');
if (isset($_POST['last_update_submit'])) {
$validator->date()->validate('last_update_submit');
} else {
$validator->date()->validate('last_update');
}
$validator->required()->validate('last_update');
// check for errors
if ($validator->hasErrors()) {
$_SESSION['phpfb']['errors']['form-edit-actor'] = $validator->getAllErrors();
} else {
// PowerLitePDO: the container is defined in conf.php
$db = POWERLITEPDO_CONTAINER->get(Db::class);
if (DEBUG_DB_QUERIES) {
$db->setDebug('silent');
}
$values = array();
$values['first_name'] = $_POST['first_name'];
$values['last_name'] = $_POST['last_name'];
$value_date = $_POST['last_update'];
$value_time = $_POST['last_update-time'];
if (isset($_POST['last_update_submit'])) {
$value_date = $_POST['last_update_submit'];
}
if (isset($_POST['last_update-time_submit'])) {
$value_time = $_POST['last_update-time_submit'];
}
if (trim($value_date . ' ' . $value_time) == '') {
$values['last_update'] = null;
} else {
$values['last_update'] = $value_date . ' ' . $value_time;
}
$where = $_SESSION['actor_editable_primary_keys'];
// begin transaction
$db->transactionBegin();
try {
// update actor
if (DEMO !== true && $db->update('actor', $values, $where, DEBUG_DB_QUERIES ? 'silent' : false) === false) {
$error = DEBUG_DB_QUERIES ? $db->getDebug()->get() : DB_ERROR;
throw new \Exception($error);
} else {
if (DEMO !== true && DEBUG_DB_QUERIES) {
$debug_content .= $db->getDebug()->get();
}
// get records from film_actor
$film_actor_current_records = array();
// Array with film.film_id
$film_actor_records_to_add = array();
// Array with film_actor.actor_id
$film_actor_records_to_delete = array();
$from = 'film_actor';
$columns = array('film_id');
$where = array('actor_id' => $_SESSION['actor_editable_primary_keys']['actor.actor_id']);
$db->select($from, $columns, $where, array(), DEBUG_DB_QUERIES ? 'silent' : false);
if (DEBUG_DB_QUERIES) {
$debug_content .= $db->getDebug()->get();
}
$db_count = $db->numRows();
if (!empty($db_count)) {
while ($row = $db->fetch()) {
$film_actor_current_records[] = $row->film_id;
}
}
foreach ($_POST['ext_film'] as $film_value) {
if (!in_array($film_value, $film_actor_current_records)) {
$film_actor_records_to_add[] = $film_value;
}
}
foreach ($film_actor_current_records as $film_value) {
if (!in_array($film_value, $_POST['ext_film'])) {
$film_actor_records_to_delete[] = $film_value;
}
}
// insert records in film_actor
foreach ($film_actor_records_to_add as $value) {
$values = array();
$values['actor_id'] = $_SESSION['actor_editable_primary_keys']['actor.actor_id'];
$values['film_id'] = $value;
if (DEMO !== true && $db->insert('film_actor', $values, DEBUG_DB_QUERIES ? 'silent' : false) === false) {
$error = DEBUG_DB_QUERIES ? $db->getDebug()->get() : DB_ERROR;
throw new \Exception($error);
}
}
// delete records from film_actor
foreach ($film_actor_records_to_delete as $film_id_value) {
$where = array();
$where['actor_id'] = $_SESSION['actor_editable_primary_keys']['actor.actor_id'];
$where['film_id'] = $film_id_value;
if (DEMO !== true && $db->delete('film_actor', $where, DEBUG_DB_QUERIES ? 'silent' : false) === false) {
$error = DEBUG_DB_QUERIES ? $db->getDebug()->get() : DB_ERROR;
throw new \Exception($error);
}
}
// ALL OK
if (!DEBUG_DB_QUERIES) {
$db->transactionCommit();
$_SESSION['msg'] = Utils::alert(UPDATE_SUCCESS_MESSAGE, 'alert-success has-icon');
// reset form values
Form::clear('form-edit-actor');
// redirect to list page
if (isset($_SESSION['active_list_url'])) {
header('Location:' . $_SESSION['active_list_url']);
} else {
header('Location:' . ADMIN_URL . 'actor');
}
// if we don't exit here, $_SESSION['msg'] will be unset
exit();
} else {
$db->transactionRollback();
$_SESSION['msg'] = Utils::alert(UPDATE_SUCCESS_MESSAGE . '<br>(' . DEBUG_DB_QUERIES_ENABLED . ')', 'alert-success has-icon');
}
}
} catch (\Exception $e) {
$db->transactionRollback();
$msg_content = DB_ERROR;
if (DEBUG) {
$msg_content .= '<br>' . $e->getMessage();
}
$_SESSION['msg'] = Utils::alert($msg_content, 'alert-danger has-icon');
}
} // END else
} // END if POST
// register editable primary keys, which are NOT posted and will be the query update filter
// $params come from data-forms.php
// replace 'fieldname' with 'table.fieldname' to avoid ambigous query
$where_params = array_combine(
array_map(function ($k) {
return 'actor.' . $k;
}, array_keys($params)),
$params
);
$_SESSION['actor_editable_primary_keys'] = $where_params;
if (!isset($_SESSION['phpfb']['errors']['form-edit-actor']) || empty($_SESSION['phpfb']['errors']['form-edit-actor'])) { // If no error registered
$from = 'actor';
$columns = '*';
$where = $_SESSION['actor_editable_primary_keys'];
// if restricted rights
if (ADMIN_LOCKED === true && Secure::canUpdateRestricted('actor')) {
$where = array_merge($where, Secure::getRestrictionQuery('actor'));
}
$db = POWERLITEPDO_CONTAINER->get(Db::class);
$db->select($from, $columns, $where, array(), DEBUG_DB_QUERIES ? 'silent' : false);
if ($db->numRows() < 1) {
if (DEBUG) {
exit('No Record Found');
} else {
exit('No Record Found');
}
}
if (DEBUG_DB_QUERIES) {
$debug_content .= $db->getDebug()->get();
}
$row = $db->fetch();
$_SESSION['phpfb']['form-edit-actor']['actor_id'] = $row->actor_id;
$_SESSION['phpfb']['form-edit-actor']['first_name'] = $row->first_name;
$_SESSION['phpfb']['form-edit-actor']['last_name'] = $row->last_name;
$last_update_ts = null;
if (!is_null($row->last_update)) {
$last_update_ts = strtotime($row->last_update);
}
// if timestamp is valid and > '1970-01-01'
if (!is_null($last_update_ts) && Utils::isValidTimeStamp($last_update_ts) && $last_update_ts > -62169984000) {
$_SESSION['phpfb']['form-edit-actor']['last_update'] = date('Y-m-d', $last_update_ts);
$_SESSION['phpfb']['form-edit-actor']['last_update-time'] = date('H:i', $last_update_ts);
} else {
$_SESSION['phpfb']['form-edit-actor']['last_update'] = null;
$_SESSION['phpfb']['form-edit-actor']['last_update-time'] = null;
}
}
$_SESSION['phpfb']['form-edit-actor']['ext_film'] = array();
$from = 'film_actor';
$columns = array('film_id');
$where = array('actor_id' => $_SESSION['actor_editable_primary_keys']['actor.actor_id']);
$db = POWERLITEPDO_CONTAINER->get(Db::class);
$db->select($from, $columns, $where, array(), DEBUG_DB_QUERIES ? 'silent' : false);
if (DEBUG_DB_QUERIES) {
$debug_content .= $db->getDebug()->get();
}
$db_count = $db->numRows();
if (!empty($db_count)) {
while ($row = $db->fetch()) {
$_SESSION['phpfb']['form-edit-actor']['ext_film'][] = $row->film_id;
}
}
// $params come from data-forms.php
$pk_url_params = http_build_query($params, '', '/');
$form = new Form('form-edit-actor', 'horizontal', 'novalidate');
$form->setAction(ADMIN_URL . 'actor/edit/' . $pk_url_params);
$form->startFieldset();
// actor_id --
$form->setCols(2, 10);
$form->addInput('hidden', 'actor_id', '');
// first_name --
$form->setCols(2, 10);
$form->addInput('text', 'first_name', '', 'First Name', 'required');
// last_name --
$form->addInput('text', 'last_name', '', 'Last Name', 'required');
// last_update --
$form->groupElements('last_update', 'last_update-time');
$form->addPlugin('pickadate', '#last_update'); // date field
$form->addPlugin('pickadate', '#last_update-time', 'pickatime'); // time field
$form->setCols(2, 6);
$form->addInput('text', 'last_update', '', 'Last Update', 'required, data-format=dd mmmm yyyy, data-format-submit=yyyy-mm-dd, data-set-default-date=true');
$form->setCols(0, 4);
if (DATETIMEPICKERS_STYLE === 'material') {
$form->addInput('text', 'last_update-time', '', '', 'required, data-format=hh:i A, data-format-submit=HH:i, data-twelve-hour=false, data-interval=15, placeholder=Time');
} else {
$form->addInput('text', 'last_update-time', '', '', 'required, data-format=H:i a, data-format-submit=HH:i, data-interval=15, placeholder=Time');
}
$form->setCols(2, 10);
// external relation: actor => film_actor => film;
$from = 'film';
$columns = 'title, film_id';
$where = false;
$extras = array(
'selectDistinct' => true
);
$db = POWERLITEPDO_CONTAINER->get(Db::class);
$db->select($from, $columns, $where, $extras, DEBUG_DB_QUERIES ? 'silent' : false);
if (DEBUG_DB_QUERIES) {
$debug_content .= $db->getDebug()->get();
}
$db_count = $db->numRows();
if (!empty($db_count)) {
$values = array();
$display_values = array();
while ($row = $db->fetch()) {
$values[] = $row->film_id;
$display_values[] = $row->title;
}
for ($i = 0; $i < $db_count; $i++) {
$form->addOption('ext_film[]', $values[$i], $display_values[$i]);
}
$form->addSelect('ext_film[]', 'Film', 'data-slimselect=true, multiple, data-close-on-select=false');
}
$form->addBtn('button', 'cancel', 0, '<i class="' . ICON_BACK . ' prepend"></i>' . CANCEL, 'class=btn btn-warning, data-ladda-button=true, data-style=zoom-in, onclick=history.go(-1)', 'btn-group');
$form->addBtn('submit', 'submit-btn', 1, SUBMIT . '<i class="' . ICON_CHECKMARK . ' append"></i>', 'class=btn btn-success, data-ladda-button=true, data-style=zoom-in', 'btn-group');
$form->setCols(0, 12);
$form->centerContent();
$form->printBtnGroup('btn-group');
$form->endFieldset();
$form->addPlugin('pretty-checkbox', '#form-edit-actor');
$form->addPlugin('formvalidation', '#form-edit-actor', 'default', array('language' => FORMVALIDATION_JAVASCRIPT_LANG));
Personnalisation pour les utilisateurs avancés
Si votre structure de base de données évolue en cours de route, PHPCG est capable de reconstruire les données et vous permet de régénérer les pages CRUD correspondantes.
Lors de la génération des pages du panneau d'administration, PHPCRUD conserve automatiquement une sauvegarde de la version précédente.
Les outil de comparaison de fichiers intégré au générateur vous permet de comparer côte à côte votre version actuelle et la précédente et de les fusionner en choisissant les blocs de code à conserver.
Les personnalisations de l'administration peuvent ainsi être conservées lors des changements de version/structure.
Instructions de mise à jour
Les mises à jour sont automatiques.
Lorsqu'une nouvelle version est publiée, vous verrez le message "New PHP CRUD GENERATOR version is available" dans /generator/generator.php et il vous suffira de cliquer sur le bouton "Install".
Votre numéro de version est disponible dans /conf/conf.php (VERSION)
Mise à niveau de 1.x vers 2.x
La version 2 est une mise à jour majeure. Il n'est donc pas possible de mettre à niveau depuis la version 1.
La solution consiste donc à installer la version 2, puis à reconfigurer votre panneau d'administration à partir de celle-ci.
Langues/Traduction (I18n)
PHP CRUD Generator et le panneau d'administration Bootstrap généré sont tous deux entièrement multilingues.
Pour traduire dans votre propre langue :
Dupliquez admin/i18n/en.php et renommez-le avec votre propre langue.
Effectuez les traductions dans le fichier que vous avez créé (admin/i18n/[votre-langue].php)
Ouvrez l'onglet Configuration du CRUD Generator et définissez la langue avec le nom de fichier utilisé précédemment (ou remplacez "lang": "en" par votre nom de fichier dans conf/user-conf.).
Vérifiez class/phpformbuilder/plugins/select2/js/i18n/[votre-langue].js et créez-le s'il n'existe pas.
N'hésitez pas à nous envoyer votre traduction. Elle sera utile aux autres utilisateurs.
PHP Form Builder
PHP Form Builder est inclus dans le package, et vous pouvez l'utiliser sans restriction sur le même domaine que votre CRUD.
Cela signifie que vous pouvez créer tous les formulaires que vous souhaitez sur votre site/projet et utiliser les plugins et fonctionnalités intégrés.
Pour utiliser PHP Form Builder dans votre projet, créez un fichier PHP où vous souhaitez ajouter un formulaire ou ouvrez n'importe quel fichier PHP existant, puis ajoutez ce code tout au début de celui-ci :
Vous pouvez ensuite créer vos formulaires. La documentation est disponible sur le site officiel : https://www.phpformbuilder.pro
Form Builder glisser-déposer & Templates
Le Form Builder glisser-déposer et les templates de formulaires ne sont pas inclus dans le package de PHP CRUD Generator. Ce n'est pas une restriction, mais simplement parce qu'ils sont disponibles en ligne, et la plupart des utilisateurs n'en ont pas besoin, réduisant ainsi le poids du package PHPCG.
Si vous souhaitez les télécharger, ils sont disponibles ici :
Le fichier ZIP contient deux répertoires : drag-n-drop-form-builder et templates
Form Builder glisser-déposer
Placez le drag-n-drop-form-builder répertoire dans le classe dossier, juste à côté du phpformbuilder dossier. Vous pouvez ensuite ouvrir /class/drag-n-drop-form-builder/index.html dans votre navigateur et commencer à créer vos formulaires.
Lorsque vous récupérez les codes de formulaires générés par l'outil de glisser-déposer, n'oubliez pas d'ajouter manuellement le code spécifique du CRUD Generator (comme expliqué ci-dessus) :
Placez le drag-n-drop-form-builder répertoire dans le classe dossier, juste à côté du phpformbuilder dossier. Vous pouvez ensuite ouvrir /class/drag-n-drop-form-builder/index.html dans votre navigateur et commencer à créer vos formulaires.
Les templates peut se trouver n'importe où sur votre serveur, quel que soit le dossier dans lequel il se trouve, les modèles fonctionneront parfaitement.
Sources & Crédits
Un grand merci aux auteurs pour leur excellent travail
Après toute mise à jour, fermez et rouvrez votre navigateur pour effacer la SESSION PHP
version 3.0.0 (10/2026)
New Features:
- Polar one-time-purchase license replaces the purchase code system (self-service activation, customer portal management)
- new pricing page with the Polar checkout
- reworked install wizard: step 1 combines the Polar license activation and the server prerequisites check
- server-aware database connections: db-connect.php stores up to 2 per-server connection settings (localhost + remote), selected by server fingerprint and synchronizable between environments
- new db-connection-recovery screen guides the user to the installer when no stored connection matches the current server
- generator "Reinstall" button with optional backup ZIP before uninstall
- add Danish translation (Generator, Admin panel and PHP CRUD Generator's website)
Improvements:
- PHP 8.1 required (installer check updated accordingly)
- replace the legacy diff/merge ajax layer by the visual-diff-merge package
- multilingual support of the installer and the admin templates
- new DEBUG constant (configurable from the generator settings) replaces the ENVIRONMENT constant
- automatic aria-labels on generated form fields and admin search controls (accessibility)
Bug Fix:
- remove unused PHPCG_USERDATA_TABLE definition (user_data table option no longer available)
version 2.3.12 (02/2025)
New Features:
Improvements:
- add a "refresh" button to the auto-updater to clear the cached versions
- auto-updater now displays a message for the user if the PHP ZIP extension is missing
Bug Fix:
- fix 'time' fields session values in the generator's create form
version 2.3.11 (01/2025)
New Features:
Improvements:
- manage the cases where the database connection fails or the database is empty and display a proper error message
- replace silent errors (@) with try/catch blocks
Bug Fix:
- fix database INSERT error with tables that have multiple indirect foreign keys
- fix a problem with external fields in forms that didn't show
- fix saving edited images in the image uploader when the image is preloaded from the database
- fix custom time formats storage in the generator READ lists
version 2.3.10 (11/2024)
Bug Fix:
- fix external fields indexing issue in the generator's generate create/edit form
- fix custom datetime formats storage in the generator READ lists
- fix the image uploader's editor to save files & thumbnails after editing
- rewrite the image uploader's resizing code to avoid exceeding max width & height when both are set
- fix wrong values in export data when external tables have the same fieldnames
- fix php warning in generator forms with image fields when thumbs, crop or editor are not set
- publish Db class with the latest changes for zero / null values in select queries
- fix php 8.3 types errors
version 2.3.9 (09/2024)
Bug Fix:
- fix a php8 json_decode error in the edit forms with select multiple or checkboxes
- fix a php7.7 compatibility issue with the FormExtended class
version 2.3.8 (09/2024)
New Features:
- Ability to filter data in lists by empty, null, and zero values.
Bug Fix:
- fix installer error when the default logo file doesn't exist on the server
version 2.3.7 (09/2024)
Improvements:
- upgrade PHP Form Builder to the latest version (5.3.0)
Bug Fix:
- fix generator diff-files form error for installations in a subfolder
- fix the admin filters that look for array values
- fix the "Enable the ability to change styles from the admin dashboard" option in the generator configuration form
version 2.3.6 (01/2024)
New Features:
- add a PHP Error Handler and Monitoring system with automatic email sending
- add the PHP Error Handler and Monitoring configuration to the Generator's configuration tab
- add the German translation
Bug Fix:
- fix the Material Datepicker plugin bug in admin forms
- fix pickadate time picker reported bug: https://github.com/amsul/pickadate.js/issues/1243
- fix file uploader image resizing ratios (previously not working properly in some specific cases)
version 2.3.5 (12/2023)
Improvements:
- improve Spanish translations
Bug Fix:
- fix "|raw" apprearing in the list's tables headers"
- fix quotes escaping in the forms help texts
version 2.3.4 (11/2023)
Bug Fix:
- fix a weird error with the error_log function call in DB class
- fix error with the Spanish translation
version 2.3.3 (11/2023)
New Features:
- Add PHP Errors Monitoring with email sending. Available in the generator's configuration tab.
Improvements:
- lint code with SonarLint + PHP 8.2, remove all php deprecated and warning messages
Bug Fix:
- fix a bug with "update" queries using the same fieldname in both values and where clause
version 2.3.2 (10/2023)
Improvements:
- add SQL group_by clause in DB->select() '$extras' argument
- ability to use HTML code for field titles
Bug Fix:
- the custom fieldnames are now properly displayed in the single records views
- fix image field addons display in the generator forms
- fix admin infinite loading bug in Firefox due to an internal Pace loader bug (https://github.com/CodeByZach/pace/issues/510)
version 2.3.1 (04/2023)
Bug Fix:
- fix the file comparison tab not showing the tool
- fix the broken date pickers translations
version 2.3 (03/2023)
Improvements:
- fix wrong links & images in the documentation
- database insert now returns the last insert id if supported by the db driver
Bug Fix:
- fix plugins_path in class/Form.php (PHP Form Builder) when the plugins folder URL is set with $form->setPluginsUrl()
- repair the database getLastInsertId() function
- remove PHP warning with Secure class when passing NULL to the constraint query
- fix floating values that were converted to int with input[type="number"]
- fix query error with empty filters
- fix a warning in admin forms with some special restriction queries
- fix error when sorting fields from relational tables
- fix Deprecated error in class.fileuploader.php
version 2.2 (02/2023)
Improvements:
- remove the search box in the Edit in place's boolean selects
Bug Fix:
- fix non-working Generator lock
- fix error on cascade delete - please regenerate your delete forms if they use cascade deletion to get them working properly.
version 2.1 (01/2023)
Improvements:
- authentication module installer will keep the multiselect opened when choosing the admin tables
- update the wordcharcount plugin to set the default maxWords to -1 (= infinity)
Bug Fix:
- fix a wrong query in create/update forms on external tables
- fix tinymce theme in class/phpformbuilder/plugins-config-custom/tinymce.xml
version 2.0.1 (01/2023)
Improvements:
- enable of the auto-update system for the package's version 2
Bug Fix:
- fix filters inappropriate error message when the filter data contains null values
version 2.0 (01/2023)
New Features:
- switch from Mysqli to PDO with prepared queries
- Oracle database support
- PostgreSQL database support
- Firebird database support
- upgrade to Bootstrap 5
- upgrade Bootswatch themes
- add the SCSS source files to the package
- rewrite the color palette and make use of the Bootstrap 5 color contrast utilities (.text-bg-xxx)
- replace PHP Form Builder by the latest version
- add 'Display the database errors' and 'Simulate and debug' options to the generator's general settings for easy database debugging.
- add an option to the generator's general settings to display the data tables in the viewport with or without a vertical scrollbar.
- highly improve the debugging system, which now can show all the queries (including Ajax requests), PDO parameters and performances using the 'Simulate and debug' option.
- add the ability to set a custom CSS class for the filtered columns in the admin READ
Improvements:
- auto-highlight filtered columns in the admin READ lists and remove the "Column number" setting in the generator "advanced filters" settings
- the generator's advanced filters test tool now analyzes the queries and display an explicit error message when a field are missing from the query.
- optimisation of the CRUD Generator forms and tools for more efficient loading
- complete redesign of the generator and admin dashboard User Interface (UI)
version 1.29 (08/2022)
Improvements:
- add an error message with a link to the documentation when a user opens a READ lists in the admin with the authentication module enabled and the table not registered inside it.
Bug Fix:
- fix an error with external fields multiple checkboxes
version 1.28 (07/2022)
New Features:
- Display of values from secondary relationships.
E.g: address.city_id -> city.country_id -> country.name
PHPCG now can show the country name straight from the address READ list and forms.
- Add capability to load the select options dynamically in Ajax from the database in the admin forms
Improvements:
- add 'json' in database fields types
- update and improve the file comparison tool
- test Apache FollowSymLinks + admin 404 errors in the installer and return the appropriate help messages
version 1.27 (06/2022)
Improvements:
- the installer will now show a clear message if the database connection is successful but no table is found, instead of showing a connection failure message.
Bug Fix:
- fix a missing translation in Italian
- fix a missing parenthesis in generator/generator-templates/form-edit-template.php
version 1.26 (05/2022)
Bug Fix:
- fix a missing parenthesis in generator/generator-templates/form-create-template.php
version 1.25 (05/2022)
Improvements:
- PHPCG will now preselect the current values in READ lists live-edit's select dropdowns
- the Live edit in admin READ lists will now show the values of the relational table instead after editing
- fix PHP warning with mysqli_free_result, boolean and null values & PHP 8.1
- add a loading indicator when loading Live Edit forms from the READ lists
Bug Fix:
- set mysqli_report to MYSQLI_REPORT_OFF during the installation to make sure that mysqli_query will not throw a warning when a query fails (which is normal when we test if a table exist for instance, the query returns false);
- fix all the errors in the generator with PHP8 and the count() function when some fields have been deleted from the database
- fix broken queries due to a regex that didn't include table/field names with a number in admin/class/crud/ElementFilters
- fix PHP Warning with Ajax filters in the admin dashboard
- escape JSON values in Live edit select dropdowns
version 1.24 (02/2022)
Improvements:
- add a warning to the installer if the install folder is not at the root of the project
- add the same warning to the Quick Start Guide
version 1.23 (11/2021)
Improvements:
- update the TWIG engine to 3.3.4
- add a "Select" type in the READ list generator to prevent the CREATE/UPDATE form from reverting to "text" when rebuilding the READ list
- add a message in the installer to warn users if their url has uppercase characters (uppercase are not valid and cause problems).
Bug Fix:
- replace a php arrow function call in ElementsFilters.php for php <7.4 compatibility
version 1.22 (10/2021)
Improvements:
- load the Codecanyon package images in documentation/index.html from local assets instead of Cloudinary CDN, which was not authorized for external hostnames
Bug Fix:
- fix a sql error caused by Secure users rights (Secure::getRestrictionQuery() returning a single space instead of an empty value)
- the Date Range filters now remove the NULL values to detect the minimum / maximum available dates for filter
- fix filter error with invalid JSON values in database in latest MySQL versions
- fix missing images in the documentation on users localhost.
- fix the admin search engine for relational fields with 2 values
version 1.21 (08/2021)
Bug Fix:
- the PHP integer validator will now accept null values
- In the generator - custom validation: removing a validator will now work as expected instead of always removing the last validation rule.
version 1.20 (07/2021)
New Features:
- Add a new option in the generator that allows to choose the target (intermediate or final table) of the add/edit/delete buttons for relational tables
Bug Fix:
- fix error in Material Datepicker months (error coming from the original plugin)
- fix missing ACTION header in the admin lists when the action buttons are on the right and bulk check is disabled
version 1.19 (04/2021)
Improvements:
- update the admin css to align the nested tables vertically on top
Bug Fix:
- fix broken boolean filters in the admin panel
- fix php warnings in the generator with validation auto + INT fields + MySQL v8
- restore the "add new" button for nested tables (external relations) in the admin dashboard READ lists
- fix paginated search results urls in the admin dashboard
- fix wrong links from READ lists nested tables to their edit/delete form if the nested table name contains underscores
version 1.18 (03/2021)
New Features:
- PHPCG now accepts PHP 8
Improvements:
- choice of the name of the license table during the installation process
- improve php version checking during the installation process
- update the Tinymce responsive filemanager plugin to the latest version - only in the Codecanyon package, not in the auto-update to avoid breaking customized code from users.
- improve code standards for PHP 8 compatibility
Bug Fix:
- fix issues with boolean values storage in the generator
- remove PHP warning with Ajax filters loading
- remove PHP warnings in the generator about missing relations
- fix weird field types returned by MySQL, e.g., "smallint unsigned" instead of "smallint", which is the official valid field type
version 1.17 (03/2021)
- quickly unreleased because of unexpected bugs
version 1.16 (02/2021)
New Features:
Improvements:
Bug Fix:
- fix wrong behavior of the admin delete forms when no option or "no" is selected due to a previous update
- solve assets urls issues in the main index.html and the documentation
version 1.15 (12/2020)
New Features:
- add a new 'html' field type in the generator to show the HTML content in the admin lists instead of HTML code when the fields contain HTML
- auto enable textarea + tinyMce in the generator for HTML fields
Improvements:
- add $mail->Sender in Form.php for PHPMailer to improve email deliverability
- edit the Fileuploader PHP image upload script to crop the images AFTER resizing
- (the original behavior that center-crops the original image is still available in the file code comments)
- add a default empty value in the admin forms select, radio & checkbox when the field is not required
Bug Fix:
- validator now validates integers with leading zeros (PHP :: Bug #43372)
- fix wrong ajax POST url in the admin search with paginated results
- fix textarea custom heights in CREATE forms
version 1.14 (11/2020)
New Features:
- add field height option for textarea in the generator
Improvements:
- Accept NULL date / time instead of registering the default '1970-01-01 00:00' timestamp in database
- sanitize directory separator in class/Form.php to avoid wrong plugins url detection on server with inconsistent $_SERVER['SCRIPT_NAME'] and $_SERVER['SCRIPT_FILENAME'] values
- show tinymce and word char count in the generator only for textarea
Bug Fix:
- remove php warning when posting a delete form without choosing yes/no
version 1.13.3 (11/2020)
Improvements:
- improve scrolling behavior in admin nested tables show / hide
Bug Fix:
- fix non-working nested tables show / hide due to the new OverlayScrollbars plugin
version 1.13.2 (11/2020)
Bug Fix:
- replace the deprecated admin table scrollbar plugin broken by the latest jQuery with the great new OverlayScrollbars plugin
version 1.13.1 (11/2020)
New Features:
- new tutorial to customize the admin Home page: https://www.phpcrudgenerator.com/tutorials/customize-the-bootstrap-admin-homepage
- add documentation to update the Authentication Module with a simple SQL query instead of reinstalling from scratch:
https://www.phpcrudgenerator.com/documentation/index#admin-user-authentication-module
Bug Fix:
- fix a bug in the General Settings Form due to the previous update
version 1.13 (11/2020)
Bug Fix:
- update jQuery to 3.5.1 due to a recent browser bug that prevented the generator forms to submit (nothing happened after clicking the submit button)
version 1.12 (11/2020)
Bug Fix:
- prefill the generator create/update form properly with TinyMce and character counter options & values
- remove php warning when installing the authentication module
- move the generator scripts to the <head> part to avoid jQuery not loaded error in some special circumstances
- change the target table in READ lists nested tables EDIT buttons to the end relationnal table instead of intermediate
- edit class/Utils/isValidTimeStamp function to return true with number entry as well as string
version 1.11 (09/2020)
Improvements:
- trim $url in CrudTwigExtension::ifRemoteFileExists($url) - vendor/twig/twig/src/Extension/CrudTwigExtension.php
- replace "url" property in object classes with "item_url" to avoid conflicts with database fields named "url"
Bug Fix:
- fix php Notice when building single record READ lists
- add empty default value in create / update forms for fields that get their values from a table when no record exist
- fix the filtered columns overlay colored by colorColumns in the admin READ lists
- fix wrong default dates / times in UPDATE forms with the pickadate & material date/time pickers hidden fields
- fix date value with date pickers when a form is posted with errors
- fix the index of the colored columns in READ lists when some filters are active with bulk delete enabled and admin action buttons are on the left
version 1.10 (06/2020)
Improvements:
- add "open url button" link to the documentation in the generator
- better date & time formats management with the material datepicker plugin
(rebuild your create/update forms if you want to benefit from these changes)
Bug Fix:
- fix date and time custom formats with translations in the create / edit forms
- add missing session_start() in ajax bulk delete forms
version 1.9 (06/2020)
New Features:
- add Bulk Delete capabilities to the admin dashboard's data lists
- add date range picker filter to the generator filters options + the admin dashboard's data lists
- add "Default field for search" option to the generator
Improvements:
- improve the generator design consistency
- improve root path detection for servers with inconsistent directory separators
- collapse admin inactive sidebar categories on categorie click
Bug Fix:
- fix Ajax filter results when the result options use 2 field names
version 1.8 (05/2020)
Improvements:
- add timezone to the generator general settings
- update PHP Form Builder to the latest version (4.4)
- upgrade Twig to Twig 3.0 and others vendor libraries for PHP 7.4.x compatibility
- add php DOM extension test in the installer's server capabilities tests
- add a clear error message with a link to the help center on root path detection failure
- add a loading indicator to the auto-updater
Bug Fix:
- fix wrong urls in admin forms when moving the admin files from localhost to the production server
- fix the missing relational values in the exported data
- fix admin login failure after reinstalling the authentication module with changing the user table name
- replace the double quotes with single quotes in the generator delete form template main query
version 1.7.7 (04/2020)
Bug Fix:
- fix stupid ROOT path error with subfolder installations due to the previous update
version 1.7.6 (04/2020)
Improvements:
- add a server test file in the install folder to debug paths & urls
- auto-apply ORDER BY changes from the generator to the admin panel without clearing PHP session
- update ElementFilters to allow simple quotes in advanced filters
Bug Fix:
- fix ROOT path with server alias
version 1.7.5 (04/2020)
New Features:
- add an "Ajax loading" option in the generator READ Lists filters (default: false)
Hint: Enable Ajax loading on all the tables that contain a lot of records
This new option allows to load the filters options on demand and will GREATLY improve the loading speed
- add ORDER BY in the generator READ List main settings
- add website search to https://www.phpcrudgenerator.com documentation, tutorials & help center
- add default skin loader for each Bootstrap admin theme CSS in the general settings form
- add the item name in the admin header h1
- add a footer template for admin READ lists (admin/templates/footer.html)
Improvements:
- cleaner generator design
- add instructions to solve 404 errors on some servers (lightspeed) in the help center + admin/.htaccess
- various minor optimizations
Bug Fix:
- fix Tinymce's Responsive file manager url
- edit the cUrl test file in install/
version 1.7.4 (12/2019)
New Features:
- new setting available to choose to show search results in all on the same page or in a paginated list
IMPORTANT: regenerate your READ lists from the generator if you want the paginated search results
or your paginated results will lead to 404 NOT FOUND
Bug Fix:
- fix nested table records in READ lists with only the primary key displayed
- fix the "add new" button link (previously to 404) in READ lists nested tables with page > 1
- the generator delete form now sets the correct stored options for external tables records
version 1.7.3 (12/2019)
New Features:
- add an "Advanced" section in the tutorials with a new "Date and Time formats management logic tutorial
Bug Fix:
- fix wrong date / time formats in admin READ lists for servers without PHP intl extension in some random cases depending on the chosen format
- fix date / time format dropdown helpers in the generator
version 1.7.2 (11/2019)
Improvements:
- add Czech translation
- improve documentation
Bug Fix:
- fix PHP warnings with forms & array values
- fix error in general settings form when no logo is registered
- fix filters query with number values & MySQL 5.7+
- fix error in the Italian translation
- fix PHP warning caused by primary keys aliases in the admin READ lists external relations
version 1.7.1 (08/2019)
Bug Fix:
- Fix the Admin Dropdown Search field cross-browser compatibility
(rebuild your lists to apply)
version 1.7 (08/2019)
New Features:
- New live search with Ajax Autocomplete for Bootstrap Admin Panel READ lists
(rebuild your lists to apply)
Improvements:
- Update Material Pickers for compatibility
version 1.6.1 (07/2019)
New Features:
- Admin filters now can deal with JSON array values (select multiple, checkboxes)
- New PHP CRUD Generator Tutorials channel on Youtube
Improvements:
- Array values from database now displayed as comma-separated values instead of raw JSON
- improve the online Documentation & Tutorials
Bug Fix:
- Rewrite code to limit users rights to their own records
(rebuild your lists / forms to apply)
Improvements:
- The General Settings form in the generator now allows to change the Bootstrap admin main body class
Bug Fix:
- the installer was broken by the previous changes. Solved now.
- Edit in place is no more available in Admin READ lists for users with insufficient rights
- the broken "enable/disable" authentication module in the Generator now works again
version 1.5.5 (06/2019)
New Features:
- The date & Time pickers languages can now be defined in the General Settings form
- You can now choose the style of the Bootstrap admin date & Time pickers
(default | Material Design)
- New Italian translation - Many thanks to Alberto
version 1.5.4 (06/2019)
New Features:
- New General Settings form available in the Generator
- The action buttons of the Bootstrap Admin panel can now be on the left or right of the table
- The filters of the Bootstrap Admin panel can now be triggered automatically when selected
- You can change the site title and admin logo using the General Settings form
- You can change the admin language using the General Settings form
- You can change the admin skin using the General Settings form
Improvements:
- Show custom table names in Admin READ lists nested tables
Bug Fix:
- The Validation button in the Generator should now never overlap the forms
version 1.5.3 (06/2019)
New Features:
- Action buttons in the admin panel can now be displayed in the
1st column of the admin READ lists
Improvements:
- Responsive & others in admin CSS
Bug Fix:
- datepicker plugin
- files & images upload
- tooltips
(these bugs were due to the previous update with latest PHP Form Builder)
New Features:
- replace PHP Form Builder with the latest version 4.2.1
Improvements:
- Admin Panel Fast Loading optimization with the new LoadJS features
- PHP CRUD Fast Loading optimization with the new LoadJS features
- rewrite queries for admin restricted users rights
- upgrade Bootstrap to the latest version 4.3.1
- minor various others improvements
version 1.4.9 (05/2019)
New Features:
- add new Export features (print - current view - all records) in admin READ lists
version 1.4.8 (02/2019)
New Features:
Improvements:
- add (very) strong protection for fileuploader plugin uploads
Bug Fix:
- remove some PHP warnings
- solved admin sidebar duplicate items issue
version 1.4.7 (02/2019)
Bug Fix:
- fix navbar issue with empty icons
version 1.4.6 (02/2019)
New Features:
- New "array" field type in generator for checkboxes & select multiple values
will show JSON decoded values in the READ lists
Improvements:
- better admin navbar content management ("Organize Navbar")
- improve array values management in the generator
Bug Fix:
- fix non-working select multiple with "set" & "enum" field types
- fix changelog url in auto-update success message
version 1.4.5 (02/2019)
New Features:
- License system now accepts domain with multiple extensions
e.g., domain.com, domain.eu, domain.co.uk are all valid with the same license.
- New button in the Generator to reload fresh database structure
(When you add or remove tables)
Improvements:
Bug Fix:
- admin filters now accept zero values
- fix queries in admin lists on external tables with direct relation (no intermediate table)
version 1.4.4 (02/2019)
New Features:
- external records from relational tables can now be managed
from the READ LISTS & the CREATE/UPDATE forms (!)
- add self-referential foreign keys management
- tables can now be removed/re-enabled from the admin navbar
- add Spanish admin translation (Thanks to Sergio)
Improvements:
- export buttons (csv/xls[x]) now export the exact filtered list items
- align single fields on the left in admin panels
Bug Fix:
- remove phone validation in auth. module installer
- logout from generator/generator.php now does its job as intended
- upgrade PHPMailer to latest 6.0.6 to fix PHP 7.3 warnings
version 1.4.3 (12/2018)
Bug Fix:
- fix inverted label & value in form CREATE/EDIT templates
- protect relation tables SELECT queries in form CREATE/EDIT templates
version 1.4.2 (10/2018)
New Features:
- new "Add New" button in admin READ lists on external nested tables even if no record
Improvements:
- ADMIN panel: register URL query parameters in $_GET (Altorouter ROUTES doesn't deal with these).
- the ADMIN ADD & UPDATE forms now redirect to the correct list if we come from a nested table (external relation)
- move date_default_timezone_set from conf/conf.php to conf/user-conf.php
- add Help & instructions for Microsoft IIS & NGINX servers
Bug Fix:
- "Add New" button in admin READ lists now always targets the right CREATE form
even if there's several external nested tables in the list.
- Fix several warnings & minor issues
version 1.4.1 (10/2018)
New Features:
- add "Add New", "Edit" & "Delete" buttons in READ Lists nested tables for external tables records
Improvements:
- add compatibility for date & time without PHP intl extension
Bug Fix:
- definitely fix the Apache mod_security error on the install process with some misconfigured servers
version 1.4 (10/2018)
Attention : si vos listes ADMIN en lecture contiennent des champs de type date ou datetime, ouvrez les modèles correspondants dans /admin/templates, trouvez les fonctions toDate(...) et remplacez le format de date PHP par le format correspondant format de date ICU.
New Features:
- PHPCG includes now the complete latest PHP Form Builder version with all its features & plugins.
- Add the online knowledge base with numerous tutorials & videos
Improvements:
- improve date & time translations management - https://www.phpcrudgenerator.com/tutorials/translate-dates-times-in-admin-panel
- add full date & time translation in admin lists & forms
- change admin form action from absolute url to root relative url
- add install/curl-test.php to help with CURL debbuging
Bug Fix:
- the generator now retrieves the correct stored values to be displayed in READ lists for the external fields
- get the correct time value in admin edit forms with datetime fields
- solve plugins URL detection with paths containing uppercase letters
version 1.3.2 (08/2018)
Improvements:
- dates edit in place now get the current field value
- image now crop from the center
Bug Fix:
- fix missing fields in update forms due to previous update error
- fix admin lists bug with fields having uppercase characters
- fix admin edit in place with dates & uppercase table name
version 1.3.1 (08/2018)
Improvements:
Bug Fix:
- fix Generator form create profiles
version 1.3 (08/2018)
Notes:
- After this update you may have to reinstall the user authentication module from the Generator page.
Improvements:
- update server-side validation functions to accept empty values,
except for the validators whose internal logic make values required.
Details available here: https://www.phpformbuilder.pro/documentation/class-doc.php#php-validation-methods
- the User Authentication Module now keeps the users & users profiles tables and records when uninstalling.
- the User Authentication Module can now be reinstalled even if the users & users profiles table exist
- improve user profiles management and rights limitations
- the users rights changes now take effect without clearing the session
- the admin sidebar doesn't show empty categories anymore
- the only required fields in users table are now name, firstname, profile ID, email, pass & active
(takes effect on new User Authentication Module installs only)
- add simulate property to Generator.php to simulate when we reset a table structure from generator
- remove several warnings & improve various feedback messages
Bug Fix:
- solve problem with updates & SSL errors on misconfigured servers
version 1.2.4 (07/2018)
Notes:
- After this update you may have to reinstall the user authentication module from the Generator page.
Improvements:
- set default empty value for passwords in UPDATE FORMS
Bug Fix:
- solve CREATE/UPDATE forms generation with custom validation
- solve READ LISTS generation with advanced filders
- solve image path in admin when the field thumbs are not enabled
- remove password validation in UPDATE FORMS if posted value is empty
- correct select values count in generator CREATE/UPDATE forms with custom values
- solve error 500 when adding new users
version 1.2.3 (07/2018)
New Features:
- add an uninstallation process
- add a login module for the generator on the production server
- primary key management in admin forms
Improvements:
- remove the "select database" form in generator & auto select the correct database
- add warnings for non-standard tables & field names (hyphenated)
- improve password fields management in CREATE/UPDATE forms:
better password encryption with Secure class
password are now automatically optional on update forms with an helper text: "Leave blank to keep the current password"
- turn fileuploader debug on for CREATE/UPDATE forms
- improve documentation
- improve auto-validation detection according to forms & database field types
Bug Fix:
- revert Twig template engine to version 1.35.4 to preserve PHP < 7.0 compatibility
- regenerate css & js combined plugin files for CREATE/UPDATE forms when the forms are edited with the generator
- fix generator which failed to validate when custom validators were selected while generating the CREATE/UPDATE forms
- fix password encryption when changes are made in CREATE/UPDATE users table
version 1.2.2 (07/2018)
Improvements:
- add user-conf file to avoid breaking user custom settings with updates
- move the install folder outside the generator folder.
- improve the updater script
- improve url & path management
Bug Fix:
- fix server issues in some special configurations
version 2.2.1 (07/2018)
Attention : si votre module d'authentification n'est pas activé, après la mise à jour ouvrez php-crud-generator/conf/admin-lock.php et définissez ADMIN_LOCKED à false.
Improvements:
- move ADMIN_LOCKED and ADMIN_LOGO to separate files for easier updates
Bug Fix:
- fix several minor bugs