Productos » WIRIS Plugins » Documentación

Instrucciones de instalación: WIRIS plugin para CKEditor

DESCARGAR

1 Requisitos

  • CKEditor 3.0 o superior instalado.
  • CKEditor 4.0 o superior debe usar el  modo Stardard editor. El soporte para el modo Inline editing estará disponible en breve.
  • Una licencia válida para instalar el plugin en un entorno de producción; de lo contrario, puedes utilizar el archivo descargado solo como demo.

2 Copiar archivos

Descomprime CKEditor WIRIS plugin y copia el directorio ckeditor_wiris en el directorio de plugins de CKEditor. Por ejemplo, tendrás ckeditor/plugins/ckeditor_wiris . El nombre del directorio de plugins de WIRIS debe ser ckeditor_wiris.

2.1 Para servidores PHP

  1. Otorga derechos de ejecución al usuario del servidor web sobre los archivos PHP contenidos en ckeditor/plugins/ckeditor_wiris/integration.
  2. Otorga permisos de escritura a los directorios ckeditor/plugins/ckeditor_wiris/cache y ckeditor/plugins/ckeditor_wiris/formulas al usuario del servidor web. Las carpetas se utilizarán para almacenar códigos MathML de fórmulas e imágenes temporales.

2.2 Para servidores ASP.NET

  1. Crea una aplicación a través del panel de control IIS con directorio raíz en ckeditor/plugins/ckeditor_wiris/integration.
  2. Otorga permisos de escritura a los directorios ckeditor/plugins/ckeditor_wiris/cache y ckeditor/plugins/ckeditor_wiris/formulas al usuario del servidor web. Las carpetas se utilizarán para almacenar códigos MathML de fórmulas e imágenes temporales.

2.3 Para servidores ASP

  1. Otorga permisos de escritura a los directorios ckeditor/plugins/ckeditor_wiris/cache y ckeditor/plugins/ckeditor_wiris/formulas al usuario del servidor web. Las carpetas se utilizarán para almacenar códigos MathML de fórmulas e imágenes temporales.

2.4 Como servlet Java

  1. Instala pluginwiris_engine.war en tu servidor de aplicaciones web Java. Por ejemplo, tomcat.
  2. Por defecto, el código javascript carga pluginwiris_engine de la raíz del servidor de aplicaciones web (/pluginwiris_engine/app). Sin embargo, si quieres almacenar pluginwiris_engine en otra ruta, debes editar estos códigos javascript.
    1. Abre ckeditor/plugins/ckeditor_wiris/plugin.js.
    2. Cambia las variables _wrs_conf_editorPath, _wrs_conf_CASPath, _wrs_conf_createimagePath y _wrs_conf_createcasimagePath por los valores que prefieras.
    3. Guarda los cambios.

3 Configuración

3.1 En integraciones de PHP, ASP.NET y ASP

Edita ckeditor/plugins/ckeditor_wiris/configuration.ini para definir tus propios valores. En esta tabla se especifican todos los parámetros posibles.

3.2 En integraciones de Java

Edita WEB-INF/pluginwiris/configuration.ini para definir tus propios valores. En esta tabla se especifican todos los parámetros posibles.

Es imprescindible establecer el valor de los parámetros wiriscachedirectory y wirisformuladirectory.

4 Incluye WIRIS plugin para CKEditor en tu propia plataforma

Debes incluir cierto contenido en tu archivo de configuración CKEditor ckeditor/config.js (consulta la documentación de CKEditor).

4.1 Para CKEditor 3

El resultado debe ser similar al siguiente:

/*
Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.html or http://ckeditor.com/license
*/
CKEDITOR.editorConfig = function( config )
{
    // Add WIRIS to the plugin list
    config.extraPlugins += (config.extraPlugins.length == 0 ? '' : ',') + 'ckeditor_wiris';

    // Add WIRIS buttons to the "Full toolbar"
    // Optionally, you can remove the following line and follow
    // http://docs.cksource.com/CKEditor_3.x/Developers_Guide/Toolbar
    config.toolbar_Full.push({ name: 'wiris', 
    items : [ 'ckeditor_wiris_formulaEditor', 'ckeditor_wiris_CAS' ]});
};

Nota: si has configurado una barra de herramientas personalizada, debes añadir los botones ['ckeditor_wiris_formulaEditor', 'ckeditor_wiris_CAS'] donde desees (consulta http://docs.cksource.com/CKEditor_3.x/Developers_Guide/Toolbar).

4.2 Para CKEditor 4

El resultado debe ser similar al siguiente:

/*
Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
For licensing, see LICENSE.html or http://ckeditor.com/license
*/
CKEDITOR.editorConfig = function( config )
{
    // Add WIRIS to the plugin list
    config.extraPlugins += (config.extraPlugins.length == 0 ? '' : ',') + 'ckeditor_wiris';
};

5 Comprueba que el plugin funciona correctamente

Con el fin de comprobar si WIRIS plugin se ha instalado correctamente, existe una página que hace algunos tests en tu servidor. Abre este enlace para ver dónde se encuentra tu página de test.

6 Limpia y realiza una copia de seguridad de tu WIRIS plugin para CKEditor

Consulta esta página.