- Compatibilidad con XF
- 2.3.x
- 2.2.x
- Descripción breve
- Create custom PHP pages with or without XF layout using this add-on. Access XF engine functions like sessions and permissions. Customize head tags, titles, content, and more per page for enhanced user experience. No restrictions on script location; flexible configuration options available.
Este add-on permite crear cualquier número de páginas PHP personalizadas con o sin el diseño de XF.
Una página personalizada tiene acceso a las funciones del motor de XF, incluyendo sesiones y permisos.
Todas las páginas personalizadas son scripts PHP individuales con configuración individual; se requiere conocimiento de PHP.
Se puede colocar la script de una página personalizada en cualquier lugar dentro o fuera del directorio de instalación de XF, sin restricciones.
Puedes configurar opcionalmente los siguientes elementos por página:
- Los items del <head> personalizado sobre los valores predeterminados de XF (probablemente desde un script externo)
- El título de la página personalizada
- El contenido de la página personalizada
- Si se envuelve el contenido superior con el diseño de XF
- Si se incluyen las metatags sociales de XF para previsualizar contenidos sociales en redes sociales
- Si se muestran los rastreadores y qué rastreador mostrar
Instrucciones de Instalación
- Instala el paquete ZIP del add-on (este es un paquete sin archivos adicionales)
- Copia el script sample.php y renómbralo como quieras
- Establece la constante del script XF a tu instalación de XF; por defecto es DIR
- Establece los valores de $head y/o $content
- Ajusta \ScriptsPages\Setup::set (abajo) y la instalación está completa
Ejemplo (sample.php)
Instrucciones Críticas
Cómo establecer parámetros externamente
Para establecer cualquier parámetro superior desde un script externo, defina la constante PHP SCRIPT_PAGE_{KEY} antes de cargar XenForo, es decir,
Una página personalizada tiene acceso a las funciones del motor de XF, incluyendo sesiones y permisos.
Todas las páginas personalizadas son scripts PHP individuales con configuración individual; se requiere conocimiento de PHP.
Se puede colocar la script de una página personalizada en cualquier lugar dentro o fuera del directorio de instalación de XF, sin restricciones.
Puedes configurar opcionalmente los siguientes elementos por página:
- Los items del <head> personalizado sobre los valores predeterminados de XF (probablemente desde un script externo)
- El título de la página personalizada
- El contenido de la página personalizada
- Si se envuelve el contenido superior con el diseño de XF
- Si se incluyen las metatags sociales de XF para previsualizar contenidos sociales en redes sociales
- Si se muestran los rastreadores y qué rastreador mostrar
Instrucciones de Instalación
- Instala el paquete ZIP del add-on (este es un paquete sin archivos adicionales)
- Copia el script sample.php y renómbralo como quieras
- Establece la constante del script XF a tu instalación de XF; por defecto es DIR
- Establece los valores de $head y/o $content
- Ajusta \ScriptsPages\Setup::set (abajo) y la instalación está completa
Ejemplo (sample.php)
PHP:
<?php
// Set PHP Reporting
error_reporting(E_ALL & ~E_NOTICE);
define('__XF__', __DIR__); // EDIT VALUE IF SCRIPT IS NOT IN XF FOLDER
require __XF__ . '/src/XF.php';
XF::start(__XF__);
\ScriptsPages\Setup::set('init', true);
$app = \XF::setupApp('XF\Pub\App');
$app->start();
$request = $app->request();
// EDIT BELOW to set the page's $head and/or $content; the code below is a sample
/** ob_start();
require_once __DIR__ . DIRECTORY_SEPARATOR . pathinfo(__FILE__, PATHINFO_FILENAME) . "-head.php";
$head = ob_get_contents();
ob_end_clean(); **/
/** ob_start();
require_once __DIR__ . DIRECTORY_SEPARATOR . pathinfo(__FILE__, PATHINFO_FILENAME) . "-content.php";
$content = ob_get_contents();
ob_end_clean(); */
// EDIT BELOW TO CONFIGURE
\ScriptsPages\Setup::set([
'breadcrumbs' => ['Item 1' => '/1', 'Item 2' => '/2', 'Item 3' => '/3'],
'head' => $head,
'content' => $content
]);
// STOP HERE
$app->run()->send($request);
PHP:
[
'navigation_id' => null, // the navigation tab to highlight
'head' => null, // code to embed inside the <head> tag
'metadata' => true, // include social media meta tags like 'og:*' for social media previews
'title' => null, // the page title; if null, falls back to board title
'breadcrumbs' => true, // true to include breadcrumbs, false to not, or an array of
'content' => null, // the page content; this is required
'raw' => false // whether or not to remove the XenForo layout
]Para establecer cualquier parámetro superior desde un script externo, defina la constante PHP SCRIPT_PAGE_{KEY} antes de cargar XenForo, es decir,
Código:
define('SCRIPT_PAGE_CONTENT', '<b>Hello world</b>');
