Shortcodes — prix-elec.com (électricité & gaz)

Catalogue des shortcodes

Blocs d'offres dynamiques à déposer dans n'importe quelle page éditoriale, en une ligne de Blade. Chaque shortcode interroge le moteur de comparaison Selectra en temps réel (mise en cache 1 h), filtre les offres selon un profil de consommation centralisé — électricité ou gaz — et affiche le tableau d'offres au format du site. Modifier un profil dans config/shortcodes.php met à jour automatiquement toutes les pages qui l'utilisent.

Syntaxe & utilisation

Syntaxe Blade directe, une ligne par shortcode. Un token a la forme [nom], [nom:N] ou [nom:fournisseur]. L'argument après le : est soit un nombre (top-N offres du profil, classées par budget annuel croissant), soit un nom de fournisseur (toutes ses offres). Le radical du nom choisit l'énergie : elec* pour l'électricité, *gas pour le gaz.

Exemples

<x-shortcode code="elec:5" />


<x-shortcode code="gas:5" />


<x-shortcode code="green_elec:3" />


<x-shortcode code="elec:EDF" />


<x-shortcode code="top3:elec" />
<x-shortcode code="top3:gaz" />


<x-shortcode>[elec:3][gas:3][green_elec:3]</x-shortcode>


<x-shortcode code="elec:5" exclude-provider="edf,engie" />

Profils de consommation

Définis dans sites/prix-elec.com/config/shortcodes.php. Un seul endroit à éditer pour faire évoluer toutes les pages du site. L'électricité porte une puissance (kVA) et une consommation (kWh/an) ; le gaz porte une consommation seule. Le profil de référence Selectra est 6 000 kWh/an à 6 kVA, chaque offre étant évaluée sur l'option tarifaire qui lui est favorable (Base, Heures Creuses ou autre).

Clé	Énergie	Libellé	Profil	INSEE

Catalogue complet

Liste de tous les handlers déclarés. L'argument accepte un entier (top-N) ou un nom de fournisseur. La colonne rendu indique le composant produit : tableau d'offres (x-classement-offres) ou podium (x-top3-offres-electricite / x-top3-offres-gaz).

Shortcode	Énergie	Objet	Profil	Filtre	Rendu

Électricité · profil de référence [elec:N]

Classement des N offres d'électricité pour le profil de référence Selectra (6 000 kWh/an · 6 kVA · option tarifaire favorable à chaque offre), triées par budget annuel croissant. Le shortcode le plus courant : à placer en haut d'une page d'accueil, d'un guide ou d'un comparatif. La ligne de référence (TRV, identifiant 7) sert de base d'économies et n'est jamais listée.

Shortcode inconnu : [elec:5]

Code Blade

<x-shortcode code="elec:5" />

Électricité verte [green_elec:N]

Offres d'électricité verte (énergie d'origine renouvelable certifiée) classées par budget annuel croissant, pour le profil de référence. À privilégier sur les pages « énergie verte », « écologie » ou « offres responsables ».

Code Blade

<x-shortcode code="green_elec:5" />

Électricité prix fixe & prix indexé [fixed_elec:N]

Deux variantes filtrées du profil de référence : [fixed_elec:N] ne garde que les offres dont le prix du kWh est bloqué (1, 2 ou 3 ans), [indexed_elec:N] ne garde que les offres indexées (sur le TRV électricité ou sur un indice de marché). Utile sur les guides « prix fixe vs indexé » pour mettre les deux familles côte à côte.

Offres à prix fixe

Code Blade

<x-shortcode code="fixed_elec:5" />

Offres à prix indexé

Code Blade

<x-shortcode code="indexed_elec:5" />

Profils studio & maison [elec_studio:N]

Mêmes offres d'électricité, calculées pour un autre profil de consommation : [elec_studio:N] vise un petit logement (2 000 kWh/an · 6 kVA), [elec_maison:N] une maison chauffée à l'électricité (11 000 kWh/an · 9 kVA). Le classement change avec le profil, car la part de l'abonnement et celle du kWh varient selon le volume.

Studio / petit appartement

Code Blade

<x-shortcode code="elec_studio:5" />

Maison chauffée à l'électricité

Code Blade

<x-shortcode code="elec_maison:5" />

Gaz · profil chauffage [gas:N]

Classement des N offres de gaz pour le profil chauffage complet (14 000 kWh/an · Paris 11ᵉ, zone 2). Côté gaz, la base d'économies est le Prix Repère Gaz publié par la CRE (détecté par son nom, jamais listé). À placer en haut d'une page gaz, d'un guide chauffage ou d'un comparatif.

Code Blade

<x-shortcode code="gas:5" />

Gaz vert, prix fixe & prix indexé [green_gas:N]

Trois variantes filtrées du profil chauffage : [green_gas:N] (biogaz / gaz compensé), [fixed_gas:N] (kWh bloqué) et [indexed_gas:N] (indexé sur le Prix Repère Gaz ou un indice de marché). Mêmes règles que pour l'électricité, adaptées au réseau GRDF.

Gaz vert

Code Blade

<x-shortcode code="green_gas:5" />

Gaz à prix fixe

Code Blade

<x-shortcode code="fixed_gas:5" />

Gaz à prix indexé

Code Blade

<x-shortcode code="indexed_gas:5" />

Gaz · cuisson uniquement [cuisson_gas:N]

Offres de gaz calculées pour un ménage qui n'utilise le gaz que pour la cuisson (1 000 kWh/an · Paris 11ᵉ). À privilégier sur les pages « petits consommateurs » ou « chauffage électrique, cuisson au gaz ».

Code Blade

<x-shortcode code="cuisson_gas:5" />

Top 3 podium [top3]

Format podium à trois cartes (rang 2 à gauche, rang 1 mis en avant au centre, rang 3 à droite). Délègue à x-top3-offres-electricite ou x-top3-offres-gaz, qui possèdent leurs propres données et leur câblage monétisation. L'argument choisit l'énergie : [top3] et [top3:elec] rendent l'électricité, [top3:gaz] rend le gaz.

Top 3 électricité

Code Blade

<x-shortcode code="top3:elec" />

Top 3 gaz

Code Blade

<x-shortcode code="top3:gaz" />

Filtrer par fournisseur [elec:EDF]

Remplacer l'argument numérique par un nom (ou slug) de fournisseur renvoie toutes les offres de ce fournisseur pour le handler donné, quelle que soit l'énergie. Combinable avec n'importe quel handler : [elec:EDF], [gas:Engie], [green_elec:TotalEnergies]… Utile sur les pages fournisseur pour lister leur gamme complète.

Code Blade

<x-shortcode code="elec:EDF" />


<x-shortcode code="gas:Engie" />

Composants prix de gros (spot)

Famille de composants qui affichent le prix spot de gros de l'électricité, branchés sur les données en temps réel. Ils ne passent pas par <x-shortcode> : ce sont des composants Blade directs, surtout utilisés dans les articles /actualites/*. Le paramètre index sélectionne la zone de marché (spot_fr par défaut).

Profil horaire 24 h x-spot-chart

Graphique en barres sur 24 heures. Paramètre day : today (défaut), tomorrow ou une date YYYY-MM-DD.

Code Blade

<x-spot-chart day="today" index="spot_fr" />

Évolution 30 jours x-spot-30d

Courbe des moyennes journalières. Paramètre days : nombre de jours affichés (défaut 30).

Code Blade

<x-spot-30d days="30" index="spot_fr" />

Heatmap 12 mois x-spot-calendar

Calendrier heatmap sur 12 mois glissants — une case par jour, dégradé vert vers rouge selon le prix moyen journalier.

Code Blade

<x-spot-calendar index="spot_fr" />

Cartes de la journée x-spot-day-cards

Trois cartes synthétiques : moyenne, plus bas (heure verte), plus haut (heure rouge).

Code Blade

<x-spot-day-cards day="today" index="spot_fr" />

Carte Europe x-spot-europe-map

Carte choroplèthe de l'Europe avec dégradé et infobulles : prix spot du jour par pays.

Code Blade

<x-spot-europe-map index="spot_fr" />

Profil J+1 x-spot-tomorrow

Variante de x-spot-chart figée sur la journée du lendemain (publication après 14 h CET).

Code Blade

<x-spot-tomorrow index="spot_fr" />