Productos » WIRIS Plugins » Documentación

Instrucciones de instalación: WIRIS plugin para FCKeditor

 

 

DESCARGAR

1 Requisitos

  • FCKeditor 2.0 o superior instalado.
  • 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 FCKeditor WIRIS Plugin y copia el directorio fckeditor_wiris en el directorio de plugins de FCKeditor. Por ejemplo, tendrás fckeditor/editor/plugins/fckeditor_wiris. El nombre del directorio de plugins de WIRIS debe ser fckeditor_wiris.

2.1 Para servidores PHP

  1. Otorga derechos de ejecución al usuario del servidor web sobre los archivos PHP contenidos en fckeditor/editor/plugins/fckeditor_wiris/integration.
  2. Otorga permisos de escritura a los directorios fckeditor/editor/plugins/ckeditor_wiris/cache y fckeditor/editor/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 fckeditor/editor/plugins/fckeditor_wiris/integration.
  2. Otorga permisos de escritura a los directorios fckeditor/editor/plugins/fckeditor_wiris/cache y fckeditor/editor/plugins/fckeditor_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 fckeditor/editor/plugins/fckeditor_wiris/cache y fckeditor/editor/plugins/fckeditor_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 fckeditor/editor/plugins/fckeditor_wiris/fckplugin.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 fckeditor/editor/plugins/fckeditor_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 FCKeditor en tu propia plataforma

Debes incluir fckeditor_wiris en tu lista de plugins FCKeditor. Esta lista se especifica en fckeditor/fckconfig.js (consulta la documentación de FCKeditor).

4.1 Adición del plugin a la lista de plugins

Busca la línea:

FCKConfig.PluginsPath = FCKConfig.BasePath + 'plugins/' ;

A continuación, añade el código siguiente:

FCKConfig.Plugins.Add('fckeditor_wiris');

El resultado debe ser similar al siguiente:

FCKConfig.PluginsPath = FCKConfig.BasePath + 'plugins/' ;
FCKConfig.Plugins.Add('fckeditor_wiris');

4.2 Adición de botones de WIRIS a la barra de herramientas de FCKeditor

Busca la línea:

FCKConfig.ToolbarSets["Default"] = [

Contiene la configuración de la barra de herramientas. Añade los botones fckeditor_wiris_openFormulaEditor y fckeditor_wiris_openCAS donde desees.

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 Propiedades personalizadas de WIRIS

Los parámetros que se utilizan a la hora de crear las fórmulas (color de la tipografía, color de fondo, transparencia...) son definidos en el archivo configuration.ini. Sin embargo, es posible que en ocasiones puntuales se necesite sobreescribir estos valores en tiempo de ejecución o que se deseen tener dos editores con diferentes configuraciones funcionando a la vez.

Para solucionar el problema, se ofrece la posibilidad de especificar valores de configuración para el plugin durante la inicialización de FCKeditor.

En el siguiente fragmento de código Javascript se muestran los parámetros disponibles y cómo establecer sus valores:

var editorWithBlackBackground = new FCKeditor('blackBackground');

// WIRIS properties
editorExample.Config['wirisimagebgcolor'] = '#FFFFFF';
editorExample.Config['wirisimagesymbolcolor'] = '#000000';
editorExample.Config['wiristransparency'] = 'true';
editorExample.Config['wirisimagefontsize'] = '16';
editorExample.Config['wirisimagenumbercolor'] = '#000000';
editorExample.Config['wirisimageidentcolor'] = '#000000';
editorExample.Config['wirisformulaeditorlang'] = 'es';

7 Limpia y realiza una copia de seguridad de tu WIRIS plugin para FCKEditor

Consulta esta página.