Como crear un nuevo Módulo MKPortal?

Los módulos dan a MKportal nuevas secciones y funciones. Un módulo es algo más que una página interna, desde un módulo es posible ejecutar el código, incluir archivos, datos de proceso, etc..

Creando un simple módulo MKPortal:

Ante todo decida que nombre ponerle a su nuevo módulo. Por ejemplo, si quiere crear una sección del sitio visible sólo para usuarios registrados con el texto: " esta sección es solo para miembros. ", y decide llamar el módulo "privado". Debe seguir los pasos siguientes:

Paso 1: Crear el directorio del nuevo módulo

Cree un nuevo directorio en /mkportal/modules/ y llamelo "privado"

Paso 2: Crear un nuevo index.php

Aquí está el código del index.php completado para el módulo "privado".....

<?php

if (!defined("IN_MKP")) {
   die ("Sorry !! You cannot access this file directly.");
}

if(!$mkportals->member['id']) {
   $message = "You are not authorized to access the Private Area.";
   $mklib->error_page($message);
   exit;
}

$output = "This section for registered members only.";

$mklib->printpage("1", "1", "Private Area", $output);

?>

Ahora analizamos el código....

if (!defined("IN_MKP")) {
   die ("Sorry !! You cannot access this file directly.");
}

La primera línea es estándar y asegura que no es posible tener acceso sobre este archivo directamente desde fuera de el Portal..

if(!$mkportals->member['id']) {
   $message = "You are not authorized to access the Private Area.";
   $mklib->error_page($message);
   exit;
}

El bloque del código que comienza con "if" comprueba si el usuario tiene una ID o no y si tiene acceso hacia la página. Si el usuario no tiene una ID él no es un usuario registrado y entonces el código llama la función estándar de la Página de Error Mkportal que muestra el mensaje de error y luego la interrupción de la ejecución del Script. En cambio si el usuario tiene una ID y por lo tanto es registrado no sale el error y el código es ejecutado

$output = "This section for registered members only.";

Esta línea es simple. Aquí uno puede poner lo que quiera que se muestre en la página. Esta línea es puesta en la variable " $output" y luego esto será imprimido para mostrar por la función llamada en la siguiente línea.

$mklib->printpage("1", "1", "Private Area", $output);

Esta línea merece una pequeña explicación. Esta es la función de MkPortal más importante. Esta es la función que imprime la entrada y en realidad crea la página de HTML final. Esta función como usted ve tiene 4 argumentos (en realidad esta tiene más pero de momento nos concentraremos en la que usted mas fácilmente puede usar)

$mklib->printpage("1", "1", "Private Area", $output);

Los dos primeros argumentos representan la presentación de las columnas izquierda y derecha del Portal. Si las columnas son puestas a un (1) como en este ejemplo las columnas se comportan normalmente y siguen el mecanismo normal de MKPORTAL. Sin embargo si usted quiere la página que está a punto de ver con las columnas cerradas (por ejemplo en el módulo de Chat), usted puede poner los dos parámetros a "0". Usted también puede usar combinaciones.

$mklib->printpage("1", "1", "Private Area", $output);

El tercer parámetro representa el título de la página. En nuestro ejemplo por lo tanto "Área Privada" aparecerá encima de en la barra de título del Explorador.

$mklib->printpage("1", "1", "Private Area", $output);

El cuarto parámetro representa el contenido de la página, que se presentara en el centro. En este caso lo hemos asignado a la variable "$output" y mostrará la frase... " Esta sección es solo para miembros."

Obviamente con los módulos es posible hacer algo muy complicado (como la Galería y el área de descarga). Sin embargo pensé que sería útil explicarle el mecanismo básico de la forma más sencilla y útil para que así usted tenga un punto de partida.

Paso 3: Editar el index.php de Mkportal para incluir el nuevo módulo

Usted debe agregar el módulo al index.php de MKPortal para que el módulo pueda funcionar.

'urlobox'      =>   "urlobox",

'private'      =>   "private"

Paso 4: Subir el nuevo index.php

Suba el nuevo index.php (el index creado en el Paso 2) a /mkportal/modules/private/... Y ¡Conseguido! el nuevo módulo esta lísto y en funcionamiento . Para tener acceso al nuevo modulo escriba esta URL http://Tusitio.com/index.php?ind=privado Ahora usted puede agregar el link del módulo nuevo en la Barra de Navegación,Menú del Portal o donde usted quiera..