Sie sind auf Seite 1von 38

Estable 2.1.

2 / 2-10-2010;
Próxima versión 2.2RC2 / 2-10-2010;
Desarrollado en Java
Multi-plataforma
Licencia GNU Lesser GPL
Sitio Web http://www.xwiki.org
http://www.xwiki.com

Datos de Wikipedia
XWiki es un software tipo wiki a nivel empresarial con varias funcionalidades para este entorno.
Permite también la creación de pequeñas aplicaciones, incluyendo datos estructurados y modo script,
dentro de la propia interfaz. Para esto admite los lenguajes Velocity y Grovy que se comentarán más
abajo.
Escrita en Java y apoyada enteramente en un SGBD, generalmente MySQL o HSQLDB entre
otros SGBDs.

Historia
XWiki fue originalmente escrita por Ludovic Dubost y su primera versión data de Enero de
2003, desde Abril bajo licencia GNU. En 2006 se acoge a GNU Lesser General Public License, que es
una versión reducida de la licencia.

Características
• Contenido estructurado y scripting en linea, lo cual permite la construcción de wiki-soft.
• Gestión de permisos usuarios y grupos por wiki, espacio, página.
• Su sintaxis es procesada por XWiki Rendering Engine.
• Exportación a PDF, e importación desde ficheros tipo office a la sintaxis xWiki através de
Open Office y Lucene.
• Búsquedas a texto completo y apoyada en tags.
• Control de versiones.
• Varios protocolos para accederla WebDAV, REST, XmlRpc, GWT...
• Exportación/Importación del contenido y/o el sitio
• Plugins, API para programación...

Así como la creación de objetos y clases para la propia xWiki. Los formularios pueden ser
creados rápidamente y reutilizados por plantillas. Los usuarios pueden encontrarse con páginas donde
solo deberán rellenar los campos estrictamente necesarios.

Proyectos Open-Source en cuales se apoya

Groovy

Para scripting avanzado en xWiki. Multiparadigma orientado a objetos, aparece en 2003,


diseñado por JCP. Su última versión 1.7 data de 22-12-2009. Se caracteriza por fuerte tipado
de datos y ser dinámico, además de su influencia desde Perl, Smalltalk, Ruby, Python.
Groovy es un lenguaje de programación orientado a objetos implementado sobre la
plataforma Java. La especificación JSR 241 se encarga de su estandarización para una futura
inclusión como componente oficial de la plataforma Java como lenguaje para scripting.
Usa una sintaxis muy parecida a Java, comparte el mismo modelo de objetos, de hilos y de
seguridad. Desde Groovy se puede acceder directamente a todas las API existentes en Java.
El bytecode generado en el proceso de compilación es totalmente compatible con el
generado por el lenguaje Java para la Java Virtual Machine (JVM), por tanto puede usarse
directamente en cualquier aplicación Java, además se produce dinámicamente durante la
ejecución. Todo lo anterior unido a que la mayor parte de código escrito en Java es totalmente
válido en Groovy hacen que este lenguaje sea de muy fácil adopción para programadores Java
en comparación con otros lenguajes que generan bytecode para la JVM, tales como Jython o
JRuby. Groovy puede usarse también de manera dinámica como un lenguaje de scripting.

Caracteristicas
• Aunque lo parezca no es una capa superior que amplifique a Java. Se podría ejecutar un
fichero *.java con *.groovy pero no al contrario, realmente ahorra en codificación siendo
más compacto.
• Soporta tipado estático y dinámico, sobrecarga de operadores lógicos, iteraciones en
polimorfismo, matrices asociativas y expresiones regulares de forma nativa, además del
operador '?' para navegación segura para chequeo de variables previo a errores.

Java 5+ Groovy
for (String it : new String[] {"Rod", ["Rod", "Carlos", "Chris"].
"Carlos", "Chris"}) .findAll{it.size() <=
if (it.length() <= 4) 4}.each{println it}
System.out.println(it);

• También soporte nativo a diversos lenguajes de etiquetas con respeto a la sintaxis DOM,
de gran utilidad para manipulación de datos heterogéneos.
• No necesita precompilación, como cualquier otro lenguaje de scripts.

GroovyBeans, una versión paralela a los class AGroovyBean {


JavaBeans. Genera implícitamente String color
métodos accededores y mutadores. En el }
siguiente código setColor(String color) y def myGroovyBean = new AgroovyBean()
getColor() son implícitamente generados;
las últimas dos lineas que parecen myGroovyBean.setColor('baby blue')
acceder al color directamente realmente assert myGroovyBean.getColor() == 'baby
llaman al método implícito. blue'

Simple y consistente para el manejo de myGroovyBean.color = 'pewter'


listas y asociaciones clave, valor. assert myGroovyBean.color == 'pewter'

def movieList = ['Dersu Uzala', 'Ran']


Historia // una lista
assert movieList[2] == 'Seven Samurai'
movieList[3] = 'Casablanca'
James Strachan el primero en comentar //añade a la lista
sobre su desarrollo en Agosto de 2003. En
assert movieList.size() == 4
2007 estandarizado por JCP. Finalmente
def monthMap = [ 'January':31,'March':31 ]
liberado como Groovy 1.5.
//declara un 'map'
assert monthMap['March'] == 31
//accede a una entrada
monthMap['April'] = 30
//añade una entrada
assert monthMap.size() == 4
Hibernate

XWiki lo usa para almacenamiento en la base relacional en que se base.


Hibernate es una herramienta de Mapeo objeto-relacional para la plataforma Java (y
disponible también para .Net con el nombre de NHibernate) que facilita el mapeo de
atributos entre una base de datos relacional tradicional y el modelo de objetos de una
aplicación, mediante archivos declarativos (XML) que permiten establecer estas relaciones.
Hibernate es software libre, distribuido bajo los términos de la licencia GNU LGPL.

Características

Como todas las herramientas de su tipo, Hibernate busca solucionar el problema de la


diferencia entre los dos modelos de datos coexistentes en una aplicación: el usado en la
memoria de la computadora (orientación a objetos) y el usado en las bases de datos (modelo
relacional). Para esto permite al desarrollador detallar cómo es su modelo de datos, qué
relaciones existen y qué forma tienen. Con esta información Hibernate le permite a la
aplicación manipular los datos de la base operando sobre objetos, con todas las
características de la POO. Hibernate convertirá los datos entre los tipos utilizados por Java y
los definidos por SQL. Hibernate genera las sentencias SQL y libera al desarrollador del
manejo manual de los datos que resultan de la ejecución de dichas sentencias, manteniendo
la portabilidad entre todos los motores de bases de datos con un ligero incremento en el
tiempo de ejecución.
Diseñado para ser flexible en cuanto al esquema de tablas utilizado, para poder adaptarse a
su uso sobre una base de datos ya existente. También tiene la funcionalidad de crear la base
de datos a partir de la información disponible.
Ofrece también un lenguaje de consulta de datos llamado HQL (Hibernate Query Language),
al mismo tiempo que una API para construir las consultas, referente a lo conocido como
criteria.
Hibernate para Java puede ser utilizado en aplicaciones Java independientes o en
aplicaciones Java EE, mediante el componente Hibernate Annotations que implementa el
estándar JPA, que es parte de esta plataforma.

Historia

Hibernate fue una iniciativa de un grupo de desarrolladores dispersos alrededor del mundo
conducidos por Gavin King.
Tiempo después, JBoss Inc. (empresa comprada por Red Hat) contrató a los principales
desarrolladores de Hibernate y trabajó con ellos en brindar soporte al proyecto.
La rama actual de desarrollo de Hibernate es la 3.x, la cual incorpora nuevas características,
como una nueva arquitectura Interceptor/Callback, filtros definidos por el usuario, y —
opcionalmente— el uso de anotaciones para definir la correspondencia en lugar (o
conjuntamente con) los archivos XML. Hibernate 3 también guarda cercanía con la
especificación EJB 3.0 (aunque apareciera antes de la publicación de dicha especificación por
Java Community Process) y actúa como la espina dorsal de la implementación de EJB 3.0 en
JBoss.
Lucene

Utilizado por xWiki para indexar todo el contenido de la wiki y sus adjuntos facilitando las
búsquedas dentro de tales contenidos.
Es un API de código abierto para recuperación de información, originalmente implementada
en Java por Doug Cutting. Está apoyado por el Apache Software Foundation y se distribuye
bajo la Apache Software License. Lucene tiene versiones para otros lenguajes incluyendo
Delphi, Perl, C#, C++, Python, Ruby y PHP.
Es útil para cualquier aplicación que requiera indexado y búsqueda a texto completo. Lucene
ha sido ampliamente usado por su utilidad en la implementación de motores de búsquedas.
Por ello, a veces se confunde Lucene con un motor de búsquedas con funciones de
"crawling" y análisis de documentos en HTML incorporadas.
El centro de la arquitectura lógica de Lucene se encuentra el concepto de Documento
(Document) que contiene Campos (Fields) de texto. Esta flexibilidad permite a Lucene ser
independiente del formato del fichero. Textos que se encuentran en PDFs, páginas HTML,
documentos de Microsoft Word, así como muchos otros pueden ser indexados mientras que
se pueda extraer información de ellos.
Nutch es un software que, sobre la base aportada por Lucene, integra todo lo que
hace falta para completar un motor de búsqueda de páginas web.

Versiones

Lucene tiene o se encuentran en desarrollo de versiones para varios lenguajes de


programación además de Java:

▪Lucene4c – C ▪Montezuma - Lisp


▪CLucene – C++ ▪Ferret y RubyLucene - Ruby
▪Lucene.Net - .NET ▪Plucene - Perl
▪Pylucene – Python ▪MUTIS – Delphi
▪Zend Framework (búsquedas) – PHP ▪NLucene - .NET

Velocity

Apache Velocity (conocido como Jakarta Velocity) es un proyecto de código abierto dirigido
por Apache Software Foundation. Es una tecnología para plantillas basada en Java que
provee un lenguaje simple para plantilla que referencia a objetos definidos en código Java. Su
finalidad es asegurar una clara separación entre presentación y lógica de negocio en una
aplicación web (referente a patrones de diseño modelo-vista-controlador). Algunos tipos de
aplicaciones que se apoyan en él son:

• Aplicaciones Web: Los diseñadores de hoy crean páginas con entornos fijos para información
dinámica, estas son procesadas con VelocityViewServlet o otro de los numerosos frameworks
que soportan Velocity. Este enfoque del desarrollo web es lo llamado Modelo-Vista.
Controlador (MVC), esta visto a reemplazar a aplicaciones basadas en JSP o PHP.
• Generación del código Fuente: Puede ser usado para generar código Java, SQL o PostScript
basado en plantillas.
• E-Mails automáticos: Muchas aplicaciones generan e-mails automáticamente. Con Velocity,
el contenido del e-mail puede estar en un fichero como plantilla en vez de embebido en el
código Java.
• Transformación XML: Velocity provee de un Ant task, llamado Anakia, la cual lee un fichero
XML y lo prepara para una plantilla Velocity. Una aplicación común es convertir información
de un formato xdoc genérico a HTML.

Plantilla Resultado
## Velocity Hello World <html>
<html> <body>
<body> Hello Velocity World!
#set( $foo = "Velocity" ) </body>
## followed by </html>
Hello $foo World!
</body>
</html>

Manuales oficiales de la versión XWiki Enterprise 2.2-rc-1.26699

Documentación para XWiki Enterprise


• Guia de Usuario: Contiene una Guia de Inicio Rápido y una referencia a las características,
además de videos y manuales.
• Guia del programador: Tanto para insertar scripts en las páginas como para desarrollo de
aplicaciones en los niveles superiores de XWiki.
• Guia del Administrador
No olvidar un vistazo a Code Zone donde podemos encontrar snippets, macros, plugins,
aplicaciones y extensione, y para consultas sobre esto consultar XWiki Syntax Page. Para
información sobre colaboración en el proyecto XWiki, visite XWiki Development Zone.
Si aun así tiene problemas use la FAQ.

Características
Edición de páginas
Ciclo de vida de los Documentosycle
Usando sintaxis wiki para dar formato al
Creación, edición, renombrado, copias,
texto, crear tablas, enlaces... Como
impresión...
alternativa cuenta con un editor WYSIWYG.

Control de versiones
Cualquier cambio es salvado, pudiendo
Adjuntos
visualizar versiones anteriores de las
Tantos como se quiera por cada página.
páginas, deshacer hasta determinado
momento o comparaciones.

Administración de permisos
Exportaciones
Quien puede qué y por niveles dentro de
De las páginas a PDF, RTF, XML o HTML.
la estructura de la XWiki.
Spaces
Organizar documentos agrupándolos por Usuarios y Grupos
dominio.

Programación
Notificationes
Uso de la API Xwiki desde las páginas con
Para estar al dia con los cambios con
Velocity o Groovy para mejoras del formato,
feeds RSS y la utilidad Watchlist.
capas o cualquier cosa.

Aplicaciones y Extensiones
Office Importer
Crear aplicaciones mediante agrupación de
Conversores de documentos office a
paginas. Posibilitando su posterior
páginas de la wiki.
importación o exportación.

RESTful y XML/RPC Skins


Completo juego de plantillas, menús,
APIs para uso remoto, permiten integrar ficheros CSS permiten alta
XWiki con sus aplicaciones. personalización.

Internacionalización
Integración Portlet
Soporta varias traducciones de los
Añade XWiki como JSR168 Portlet a un
documentos y redirige automáticamente
Portal.
según idioma del perfil del usuario.

Soporte de Base de datos Escalabilidad y Actuación


Todo el contenido de la wiki es almacenado XWiki soporta wikis virtuales y hasta
en bases relacionales, use su SGBD. granjas fácilmente configurables.

Estadísticas Integradas
Plantillas para documentos y formularios
Seguir quien lee o contribuye, los más
Fácil con edición visual.
vistos...

WebDAV
Atajos con teclado Acceder a cada uno de los adjuntos y
documentos usando un cliente DAV o un
explorador.

Paquete de Aplicaciones
XWiki es una wiki de segunda generación y como tal viene con un amplio conjunto de utilidades, y
algunas más instalables.

Aplicación de Administración

Aplicación para Blogs


Transforma la wiki en una bliki.
Aplicación OfficeImporter
Importa documentos tipo office.
Aplicación para Paneles
Provee de varios paneles colocables a derecha e izquierda o incluso flotantes, provee de un
asistente en modo WYSIWYG.
Aplicación para Planificación
Permite planificar tareas ofreciendo un conjunto configurable de ellas, con la habilidad de
cancelarlas replanificarlas o editarlas si le fuera necesario.
Aplicación de busqueda
Por referencias, Spaces, o páginas pudiendo enviar los resultados por RSS.
Aplicación para estadísticas

Aplicación para tags


Etiquetación de contenidos para navegación entorno a palabras clave. También permite enlazar
estos eventos a RSS.
Aplicación Watchlist
Permite a los usuarios añadir Pages o Spaces a su watchlist. Permitiéndoles también
suscribirse a sus notificaciones por RSS o e-mail..
Aplicación Webdav
Permite la edición de adjuntos.
Aplicación puente para macros Wiki
Para creación de macros através de las páginas de la wiki

Guias XWiki Enterprise


XWiki Enterprise es un software para entornos empresariales que ofrece gestión de permisos, sistema
de Blogs, autentificación mediante LDAP, exportación de contenidos a PDF. Provee de un completo
sistema de formularios y soportes para script convirtiéndolo en un entorno de desarrollo perfecto para
aplicaciones basadas en datos. También extensible en cuanto a scripting en las páginas incluso uso de
plug-ins gracias a una arquitectura altamente modular.

¿Para que sirve?


• Intranets.
• Webs públicas.
• Administración de documentación.
• Necesidades básicas de administración de contenidos (CMS, Content Management System).
• Proyectos de colaboración.
• Portales basados en enlace de datos de fuentes externas...

Getting started
Empezar por la Guia de Usuario para ver las características y sus uso. Luego descargar e instalar
XWiki Enterprise o probarla online. Si quieres usarla como un portal mas de blogs prueba con
myxwiki.org, un servicio gratuito ofrecido por XWiki SAS.
Guía de Usuario
Enlaces
• Características
• Animaciones
• Videos

Se recomienda el uso de Playground, que es una instancia configurable de Xwiki miientras se siguen
los manuales.
Podemos encontrar una lista de macros y utilidades aquí: http://code.xwiki.org/.

Conceptos básicos
XWiki Enterprise está dividida en Spaces y Pages.

Space
Es una colleción de wiki pages. Agrupar la páginas facilita:
• Localizar páginas in cluso visualizarlas juntas o formar estructuras en árbol.
• El software permite indizar el contenido del Space facilmente.
• Se pueden ajustar los niveles dentro de los Spaces en conjunto con skins y los paneles
laterales.
• Los permisos de usuario pueden establecerse a nivel de Space.
• Limitar las búsquedas dentro del alcance del Space. También desde el modo de WebDAV.

La página de inicio de un Space es normalmente creada en .../SpaceName/WebHome.

Page
Es una unidad básica de contenido, normalmente dividida en 4 áreas:
• Barra de acciones (arriba): Permite interactuar con la página en cuestión.
• Contenido
• Paneles (derecha, izquierda o escondido.
• Area etiquetada al final del contenido:
• Comentarios
• Adjuntos que han sido subidos a dicha página.
• Historial de la Página (cada versión)
• Información del Documento (superiores e inferiores en la jerarquia del Space,
etiquetas...)
Las siguientes acciones pueden ser realizadas en una página, en función a los derechos de los
usuarios:
• Editar
• Usando el editor WYSIWYG, que es un editor de texto enriquecido.
• Usando el editor wiki: para usuarios que manejen la sintaxis XWiki.
• Imprimir y Exportar los contenidos
• Usando el menú para impresión.
• Cada Page puede ser exportada a: HTML, PDF, RTF (para MS Office) y XAR (XWiki
Archive)
• Visualización
• El usuario puede añadirla a su watchlist.
• Siempre que haya modificaciones este será notificado.
Además los administradores podrán:
• Cambiar los derechos de acceso.
• Editar los objetos y clases de las páginas.
• Renombrar, copiar y borrar las páginas.

Paneles
Es básicamente un marco con enlaces utiles que son colocados formando columnas.
Dos formas de controlarlos:
• Elegir columnas que se muestran (derecha, izquierda, ambas o ninguna)
• Elegir que paneles estarán presentes.
Son útiles para construir menús o añadir utilidades, Puede haber un conjunto diferente de paneles en
cada Space.

Primeros pasos
Si eres Administrador
En principio use estas credenciales:
• Usuario: Admin
• Contraseña: admin canovas35
Recuerde cambiarla: Ir a perfil del administrador

Cambiando el logo y los paneles


Las siguientes instrucciones se aplican a la mascara “toucan” (el unico con color y paneles en blanco a
rayas).
Para ahondar en el tema ir a la página de mascaras y/o la guía completa sobre uso de skins en
XWiki.org.

Cambiando el logo
Existen varios métodos, el más simple:
• Elegir o crear una imagen.
• Redimensionarla a 220x90px.
• Guardarla como PNG y llamarla logo.png.
• Por último subirla justo aqui. O colocarla en el directorio de la instalación y desde ahí en el de
la máscara en concreto, en este caso C:\Archivos de Programa\Apache Software
Foundation\Tomcat 5.5 1.5\webapps\xwiki\skins\colibri
Cambiando el conjunto de colores
La forma más fácil:
• Click sobre el enlace de Administración en la parte de arriba.
• Click sobre el botón "Presentación".
• En el campo "Página de estilos por defecto", reemplazar "style.css" y pruebe con cada uno
de estos:
style-black.css style-darkgray.css
style-blue.css style-gray.css
style-darkblue.css style-green.css
style-kaki.css style-purple.css
style-orange.css style-red.css
• Click en Guardar.

Cambiando los Paneles


• Click sobre el enlace Administración, en la parte de arriba.
• Click sobre Asistente de Paneles.
• La pestaña Capas de página permite definir donde quieres las columnas (derecha,
izquierda, ambas o ninguna).
• Click en la capa deseada y luego Salvar nueva capa.
• La pestaña Lista de Paneles permite seleccionar cuales se pretenden mostrar.
• Arrastrar y soltar de la página de paneles a las columnas y entre columnas para
reorganizarlos, viceversa para quitarlos.
• Luego Salvar nueva capa.

Si tiene problemas con esto use Firefox.

Crear nuevos usuarios


Si está pensando en integrar LDAP para esto eche mejor un vistazo a esta página.

• Click sobre el enlace Administración, en la parte de arriba.


• Click sobre Usuarios, y Añadir nuevo usuario.
• Rellene los campos y Guardar

Añadirlos a grupos
Agrupando usuarios será más fácil administrar sus privilegios:
• Click sobre el enlace Administración, en la parte de arriba.
• Click sobre Usuarios, y Añadir nuevo usuario.
• Rellene los campos y pulsar Crear grupo
• Para añadirle usuarios:
• Usar el icono de la columna Editar en la fila del grupo a gestionar.
• Rellenar los campos y Añadir.
Más información en administrando usuarios y grupos.
Derechos de usuario
Para más detalles.
A diferentes niveles podemos censurar diferentes cosas de las cuales permiten interacuar al usuario
con la XWiki:
• Click sobre el enlace Administración, en la parte de arriba.
• Click en Derechos.
Aquí esta lo más básico en relación a cada elemento de la wiki.
• Registro: quién permite la creación de nuevas cuentas de usuario?
• Abierto: todos pueden.
• Cerrado: administradores y usuarios registrados.
• Bloqueado: solo administradores pueden crear nuevas cuentas.
• Ver, comentar y editar las páginas
• Editable: todos pueden.
• Visible: los usuarios no registrados solo pueden ver y comentar.
• Oculto: los no registrados ni siquiera pueden visualizar.
• Protegido: solo administradores pueden ver y editar.
• Alcance de la protección: pueden los derechos globales se suplantados a otros niveles?
• Ligero: los derechos pueden ser suplantados para usuarios no registredos a nivel de
Space o Page.
• Strong: no podrán ser suplantados.

Para todos estos esquemas de seguridad dejar a los usuarios en blanco.

Wiki Abierta - Editable


Wiki Cerrada - Editable

Wiki Editable -Bloqueada

Wiki Visible - Abierta

Wiki Visible - Cerrada


Wiki Visible -Bloqueada

Wiki Oculta -Cerrada (Ligero)

Wiki Oculta – Cerrada (Fuerte)

Wiki Oculta – Bloqueada (Ligera)


Wiki Oculta – Bloqueada (Fuerte)

Wiki Protegida - Bloqueada

Si eres Usuario
Lo primero será obtener las credenciales de usuario para loguearse.

Editando una página XWiki


• Según la configuración habrá que logyearse para editar.
• En la parte de arriba a la izquierda está el botón Edición.
• Si no se ve el botón, habrá que loguearse. Si aún así no aparece debe ser que el usuario no
tiene suficientes permisos.
• Se abre una nueva página, el contenido se muestra en un editor de texto enriquecido.
• A la derecha hay un enlace donde se muestran trozos de código y como resultan.
Estas páginas permiten incluir diversos tipos de contenido para variados propositos.

Creando nuevas páginas y enlaces


Para los enlaces, seleccionar el texto, pulsar Enlace e indicar la ruta enlazada.
Si enlazamos a páginas que aún no existen, el enlace aparecerá subrayado y nos enviara a la página
en modo edición.

Page History
Siempre que se guardan cambios se registra, así permite comparar y deshacer cambios.
En el botón Ver se ofrece un desplegable con la opción History, luego podemos seleccionar y
comparar tanto el contenido como los comentarios y adjuntos.
Para más información ver Control de Versiones en Xwiki.org.
Guia del Administrador

Instalación
Como instalar o actualizar a versión superior.
Configuración
Podemos configurar XWIKI de dos formas:
• Parando la instancia de XWiki y editando el fichero xwiki/WEB-INF/xwiki.cfg, y reiniciando
XWiki tras ello.
• Accediendo como usuario con privilegios de administración e ir a la página de administración
(en la parte superior derecha de la página). Puedes ir directamente a través de la URL
siguiente: http://gerion:8080/xwiki/bin/admin/XWiki/XWikiPreferences.
Esto nos permite mantener el servidor en ejecución mientras se realizan los cambios.

AVISO: Algunas configuraciones sólo son accesibles desde el fichero xwiki.cfg y no hay nada
equivalente en la página de administración.
A continuación, veremos distintos apartados que pueden configurarse:

Habilitar cuentas de super-administrador


Editar el fichero xwiki.cfg y habilitar la propiedad xwiki.superadminpassword. Por ejemplo:
Cuando te autentiques, el usuario deberá ser superadmin y la contraseña será la que configurarás en
la propiedad xwiki.superadminpassword.

Configuración de idioma
En la página de administración, en la pestaña de preferencias, localizar el campo Default Language
(Idioma por defecto) e introducir el código de idioma que se desee (“es” para español).
Puede configurarse la wiki para soportar multilenguaje. Ver el siguiente enlace: I18 user page para más
información.
Finalmente, se puede forzar a la wiki a mostrar sólo un idioma de los especificados en la configuración,
editando el fichero WEB-INF/xwiki.cfg. Busca la sección de internacionalización, y deberías ver dos
configuraciones comentadas que deberías descomentar y actualizar a '1':
#-# By default, XWiki chooses the language specified by the client (browser). This
#-# allows to use the default language of the wiki when the user didn't manually choose a language.
# xwiki.language.preferDefault=0
#-# Force only one of the supported languages to be accepted.
# xwiki.language.forceSupported=0

MMMM dd, HH:mm Enero 27, 12:27


Formato de la fecha yyyy/MM/dd, HH:mm 2009/01/27, 12:27
Ir a Administración / general, más información.
dd/MM/yyyy, HH:mm 27/01/2009, 12:27
Configuración de acceso
Según su utilidad así será su política de acceso:
• Wiki Abierta: todos pueden editar.
• Public Wiki Pública: solo editan los usuarios registrados, pero el registro es libre, esta es la
configuración por defecto.
• Wiki privada con password with password: el registro está restringido.
• Wiki Privada con testigos para el registro: el registro esta restringido, los usuarios disponen de
un tipo de invitación.

Wiki Privada con contraseña


Derechos Globales
En Derechos globales establecer
User:XWikiGuest, Groups:, Level:register, Allow-Deny:Allow.
Registro
En Preferencias donde se indica Registro establecer Use email verification:yes. Y echar un
vistazo al resto de los campos.
Más información sobre derechos de acceso

Habilitando y deshabilitando las Estadísticas


Para habilitar y deshabilitar ponemos a 0 ó 1 respectivamente, los siguientes valores en el fichero
xwiki.cfg
• xwiki.stats Si esta encendido o no.
• xwiki.stats.default Controla lo mismo, es útil en Wikis Virtuales posteriores. El software
puede decirlo en función al valor del campo XWiki.XWikiPreferences. Si este no está definido
tomará el valor de este otro.

Versiones de Documentos
Es la funcionalidad que nos permite tanto el seguimiento de la evolución de los documentos como la
recuperación de estados anteriores. Por otro lado esto consume espacio, para deshabilitarlo en el
fichero xwiki.cfg añadir:

xwiki.store.versioning=0

Versiones de adjuntos
Las almacena por defecto, con el mismo inconveniente, para deshabilitarlo en el fichero xwiki.cfg
añadir:
xwiki.store.attachment.versioning=0

Reciclaje de Documentos
Por defecto los documento borrados no son eliminados realmente. Para deshabilitarlo en el fichero
xwiki.cfg añadir:

xwiki.recyclebin=0
Note que deshabilitar esto le hará imposible recuperar cualquier documento si no hay
una copia de respaldo de la BBDD.
Por defecto un documento borrado por un administrador es al instante, mientras que por otro tipo de
usuarios se borra tras siete días. Para reajustar esto editar en el fichero xwiki.cfg:

# Admins must wait 3 days before being allowed to permanently delete


xwiki.store.recyclebin.adminWaitDays=3 # Normal users must also wait 3 days
xwiki.store.recyclebin.waitDays=3

Reciclaje de Adjuntos
Los adjuntos borrados también van a una papelera y también pueden ser restaurados ya sea por
opción o por recuperación de una versión anterior ya sea del propio adjunto o de la página a la que se
adjunta. Para deshabilitarlo en el fichero xwiki.cfg añadir:
storage.attachment.recyclebin=0

Personalizar el aspecto
Ver la Guía para aspecto.

Configuración de la seguridad
Ver la Guía de Seguridad.

Personalizar los menús


Lo primero a entender es que los menús dependen del aspecto que se le esté dando. Si estamos
usando el Skin 1.0 es probable que la Aplicación de Paneles nos provea de diferentes paneles, siga el
enlace para ver como configurarlos y/o editarlos.

Codificación
Ver la Guía de Codificación.

Autenticación de usuarios
Ver la Guía de Autentificación.

Personalizar la página de registro


La página de registro esta definida en una plantilla (llamada registerinline.vm). Sin embargo se puede
reemplazar por una página que se nombre como XWiki.Registration.
Ver más detalles sobre como configurar la página de registro.

Personalizar la página de verificación del registro


Esta es parte de la Aplicación de Administración y permite requerir a los usuarios rellenar algunos
campo y se validen tanto en servidor como en cliente. Permite añadir campos y métodos de validación.
Para habilitar el soporte validación captcha (Completely Automated Public Turing test to tell Computers
and Humans Apart) hay que editar el fichero xwiki.properties, localizado en
xwiki/WEB-INF/xwiki.properties, añadirle:
captcha.enabled=true
Para más información ir a Aplicación de Administración.

Página de login de usuarios


Ver Página de inicio de sesión.
Configurando enlaces inter-wiki
Enlaces Interwiki vienen dados por una simple sintaxis. Por ejemplo para enlazar a
http://en.wikipedia.org/wiki/InterWiki le indicamos [InterWiki@WikiPedia].
XWiki renderiza la sintaxis Xwiki con la tecnologia Radeox, soporta estos enlaces y otros de la misma
manera que SnipSnap.
Para configurarlos:
• Crear un fichero llamado [lugar donde empiece su contenedor]/conf/intermap.txt
• Rellene conf/intermap.txt con lineas como:
IMDB http://us.imdb.com/Title? OpenWiki http://openwiki.com/?
SourceForge http://sourceforge.net/ TWiki
http://twiki.org/cgi-bin/view/ Why http://clublet.com/c/c/why?
Wiki http://c2.com/cgi/wiki? WikiPedia
http://www.wikipedia.com/wiki/

• Para añadir entradas propias:


• El análisis de sintaxis de Radeox es muy frágil, una linea de más puede dejarlo fuera de
juego.
• Reiniciar XWiki, como cada vez que se realice un cambio. Si no funciona puede echar
un vistazo a xwiki.log.

Establecer el editor por defecto – Sintaxis XWiki o WYSIWYG


Ir a la pantalla de Administración, en General
podrá seleccionarlo

Configurar el editor tipo


WYSIWYG
Ver Editor WYSIWYG para ver como habilitar y
deshabilitar sus herramientas.

Usar URLs cortas


Es posible configurar Xwiki para esto.

Reorganizar los esquemas de la BBDD


Especialmente en entornos empresariales pueden incluso hacer falta más de los preestablecidos.
• xwiki.db - nombre del esquema principal de la wiki.
• xwiki.db.prefix – útil con wikis virtuales, donde tendremos un esquema por cada una. Estos
prefijos son añadidos a los esquemas tras el mapeo entre wikis y esquemas, también aplicable
a la BBDD de la wiki principal.
Deshabilitar comentarios y adjuntos
Habrá que editar la clase XWiki.XWikiPreferences:
• Ir a <server>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=class
• Añadir una nueva propiedad showcomments o showattachments (para poner en off) de tipo
String Class
<server>/xwiki/bin/edit/XWiki/XWikiPreferences?
editor=object&classname=XWiki.XWikiPreferences
# - # and write no | yes in the showcomments or showattachments field

Comportamiento del editor de comentarios


Durante la edición de páginas tenemos un marco para comentarios, ver Edición de páginas. Para
deshabilitarlo establecer xwiki.editcomment=0 en xwiki.cfg.
Si habilitado, en xwiki.cfg estableciendo xwiki.editcomment.mandatory=1 forzará al usuario editor a
realizar un comentario, para que sea posible dejarlo en blanco deberemos indicar en el mismo fichero
xwiki.editcomment.suggested=1.
Si dejó activos algunos de estos modos, puede igualmente ocultar el recuadro del comentario con
xwiki.editcomment.hidden=0 en xwiki.cfg, lo cual provocará que salte luego trás la edición de tal
página en modo ventana flotante.
Para esto también tenemos ciertos campos en el objeto XWikiPreferences en vez de editar xwiki.cfg.
Estos campos son: editcomment, editcomment_mandatory, editcomment_suggested y
editcomment_hidden.

Uso del servido SMTP


Si se pretende usar la funcionalidad de envío de correos será necesario indicarle algunos datos
como el puerto, servidor y cuenta.
Para esto ir a https://gerion:8080/xwiki/bin/admin/XWiki/XWikiPreferences, click en general e indicar
estos datos.

Configurar la autentificación por SMTP


Estas instrucciones están ahora obsoletas.
Por defecto los campos usuario/contraseña no están
disponibles en la Preferencias. Para ésto:

• Editar la clase XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?


editor=class añadiendo dos campos, tipo String, llamados smtp_server_username y
smtp_server_password.
• Editar el objeto XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?
editor=object&classname=XWiki.XWikiPreferences&nb=0&property=smtp_server_userna
me,smtp_server_password e introducir tales datos en los recién añadidos campos.

Configurando TLS para la conexión al servidor


Estas instrucciones también están obsoletas.
Para habilitar TLS se debe:
• Editar la clase XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?
editor=class y añadir un campo tipo TextArea llamado javamail_extra_props
• Editar el objeto XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?
editor=object&classname=XWiki.XWikiPreferences&nb=0&property=javamail_extra_prop
s e introducir: mail.smtp.starttls.enable=true.
Configurando WebDAV (desde 1.7)
Está habilitado por defecto.

Asegurando el servicio WebDAV


La implementación de WebDAV solo soporta un esquema de Autentificación de acceso básica a los
clientes WebDAV, por esto es altamente recomendable el uso de SSL, hay que consultar la
documentación de su contenedor para aplicaciones web.

Deshabilitar WebDAV
Editar el fichero web.xml eliminando el elemento de mapeo de URLs que solicitan servicio WebDAV.
Similar al siguiente:

<servlet-mapping>
<servlet-name>webdav</servlet-name>
<url-pattern>/webdav/*</url-pattern>
</servlet-mapping>

Redirecciones
XWiki soporta definición de redirecciones para solicitudes entrantes. Para activarlo en xwiki.cfg
establecer:
xwiki.preferences.redirect=1
Luego para cada redirección que se quiera añadir en el fichero XWiki.XWikiPreferences principal
incluir un objeto XWiki.GlobalRedirect. Estos objetos tienen dos campos, pattern y destination. La
URL recibida se mapea al valor de lo indicado en destination.

Configuración de la sintaxis XWiki y cual por defecto


En xwiki.cfg ir a la propiedad xwiki.rendering.syntaxes y core.defaultDocumentSyntax (desde
XWiki Enterprise 1.8):
xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0,
mediawiki/1.0, xhtml/1.0, twiki/1.0
core.defaultDocumentSyntax = xwiki/2.0

Personalizando la exportación a PDF


En el futuro querremos reeditar el exportador a PDF como renderizadores en el nuevo Módulo de
Renderización.

De momento tenemos tres partes ajustables:


• El CSS utilizado para renderizar el contenido de la página a exportar como PDF/RTF
• La transformación XHTML2FO XSL.
• La transformación FOP XSL

El siguiente esquema muestra como trabaja actualmente:


Empezamos por crear una nueva clase XWiki. Simplemente creando una nueva página en modo Class
(por ejemplo http:/gerion:8080/xwiki/bin/edit/XWiki/PDFClass?editor=class). Añadirle tantos Text Area
como sean necesarios:
• style: contienen la información CSS que se usará en vez de los valores del, por defecto,
pdf.css.
• xhtmlxsl: contienen la información XHTML a FO XSL que se usará en vez de los valores por
defecto.
• fopxsl: contienen la información FOP a PDF/RTF XSL que se usarán en vez de los valores por
defecto.

Entonces crear una otra página, Xwiki.PDFTemplate, y añadirle el objeto XWiki.PDFClass.


Por último, cuando la página llame al exportador a PDF debe usar el parámetro tal que así:
http://gerion:8080/xwiki/bin/export/Space/Page?format=pdf&language=en&pdftemplate=XWiki.PDFTemplate.

Incluso en la exportación a RTF funciona, excepto en algunos detalles referentes a como CSS trata a
la capa final.

Nota: Cuando editemos código CSS no debemos dejar nunca espacios en blanco entre las reglas, esto
viene en relación al encargado de renderizar dichos ficheros.
h2 { h2 {
margin-left: 2cm; margin-left: 2cm;
margin-bottom: 1cm; margin-bottom: 1cm;
color: red; color: red;
} }
h3 {
margin: 3cm; h3 {
color: yellow; margin: 3cm;
} color: yellow;
}
Ejemplo de xwiki.cfg

#-# Default value is xwiki/1.0.


core.defaultDocumentSyntax = xwiki/2.0</tt></div><div class="box warningmessage">Hint: If it doesn't work
check that you've edited the correct configuration file.</div><h1 id="HSamplexwikicfg"><span>Sample
xwiki.cfg</span></h1><div class="box code"><tt class="wikimodel-
verbatim">#---------------------------------------
# Preamble
#
# This is the main old XWiki configuration file. Commented parameters show the default value,
#-# although some features
# might be disabled. To customize, uncomment and put your own value instead.

#---------------------------------------
# General wiki settings
#
#-# When the wiki is readonly, any updates are forbidden. To mark readonly, use one of: yes, 1, true
# xwiki.readonly=no

#-# [Since 1.6RC1] Defines the list of supported syntaxes


#-# Available syntaxes are:
#-# xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0, mediawiki/1.0,
#-# twiki/1.0, xhtml/1.0, html/4.01, plain/1.0
xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0

#-# List of groups that a new user should be added to by default after registering.
#-# Comma-separated list of group document
#-# names.
# xwiki.users.initialGroups=XWiki.XWikiAllGroup

#-# Should all users be considered members of XWiki.XWikiAllGroup, even if they don't have
#-# an associated object in the
#-# group's document?
# xwiki.authentication.group.allgroupimplicit=0

#-# Uncomment if you want to ignore requests for unmapped actions, and simply display the document
# xwiki.unknownActionResponse=view

#-# The encoding to use when transformin strings to and from byte arrays. This causes the
#-# jvm encoding to be ignored,
#-# since we want to be independend of the underlying system.
xwiki.encoding=UTF-8

#-# This parameter will activate the sectional editing.


xwiki.section.edit=1

#-# This parameter controls the depth of sections that have section editing.
#-# By default level 1 and level 2 sections have section editing.
xwiki.section.depth=2

#-# Enable backlinks storage, which increases the update time, but allows to keep track
#-# of inter document links.
xwiki.backlinks=1

#-# Enable document tags.


xwiki.tags=1
#---------------------------------------
# Storage
#
#-# Role hints that differentiate implementations of the various storage components.
#-# To add a new implementation for one
#-# of the storages, implement the appropriate interface and declare it in a components.xml
#-# file (using a role-hint other
#-# than 'default') and put its hint here.
#
#-# The main (documents) storage.
# xwiki.store.main.hint=default
#-# The attachment storage.
# xwiki.store.attachment.hint=default
#-# The document versioning storage.
# xwiki.store.versioning.hint=default
#-# The attachment versioning storage. Use 'void' to disable attachment versioning.
# xwiki.store.attachment.versioning.hint=default
#-# The document recycle bin storage.
# xwiki.store.recyclebin.hint=default
#-# The attachment recycle bin storage.
# xwiki.store.attachment.recyclebin.hint=default

#-# Whether the document recycle bin feature is activated or not


# xwiki.recyclebin=1
#-# Whether the attachment recycle bin feature is activated or not
# storage.attachment.recyclebin=1
#-# Whether the document versioning feature is activated or not
# xwiki.store.versioning=1
#-# Whether the attachment versioning feature is activated or not
# xwiki.store.attachment.versioning=1
#-# Whether the attachments should also be rolled back when a document is reverted.
# xwiki.store.rollbackattachmentwithdocuments=1

#-# The path to the hibernate configuration file.


# xwiki.store.hibernate.path=/WEB-INF/hibernate.cfg.xml

#-# Whether to update the database schema on startup. Useful when upgrading XWiki. as the mapping
#-# could change between
#-# versions, and this allows to automatically update the database. Should be disabled (=0)
#-# during normal operation to
#-# improve the startup time.
# xwiki.store.hibernate.updateschema=1

#-# Allow or disable custom mapping for particular XClasses. Custom mapping may
#-# increase the performance of certain
#-# queries when large number of objects from particular classes are used in the wiki.
# xwiki.store.hibernate.custommapping=1
#-# Dynamic custom mapping.
# xwiki.store.hibernate.custommapping.dynamic=0
#-# Put a cache in front of the document store. This greatly improves performance
#-# at the cost of memory consumption.
#-# Disable only when memory is critical.
# xwiki.store.cache=1

#-# Maximum number of documents to keep in the cache.


# xwiki.store.cache.capacity=100

#-# [Since 1.6M1]


#-# Force the database name for the main wiki in virtual mode and for the wiki itself in non virtual mode.
# xwiki.db=xwiki
#-# [Since 1.6M1]
#-# Add a prefix to all databases names of the wikis in virtual mode and to the wiki name in non virtual mode.
# xwiki.db.prefix=

#---------------------------------------
# Data migrations
#
# Similar to schema updates, this manipulates the actual data, and not just the layout of the database. Useful
#-# for migrating data to new formats, correct errors introduced in older versions, or even
#-# for schema updates that are not handled by velocity.

#-# Whether migrations are enabled or not. Should be enabled when upgrading, but for
#-# a better startup time it is better to
#-# disable them in production.
xwiki.store.migration=1

#-# Migration manager class. The default works with a Hibernate storage.
# xwiki.store.migration.manager.class=com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager

#-# Whether to exit after migration. Useful when a server should handle migrations for a
#-# large database, without going
#-# live afterwards.
# xwiki.store.migration.exitAfterEnd=0

#-# Indicate the list of databases to migrate.


#-# to upgrade all wikis database set xwiki.store.migration.databases=all
#-# to upgrade just some wikis databases set xwiki.store.migration.databases=xwiki,wiki1,wiki2
#-# Note: the main wiki is always migrated whatever the configuration.
# xwiki.store.migration.databases=

#---------------------------------------
# Internationalization
#
#-# By default, XWiki chooses the language specified by the client (browser) in the Accept-Language
#-# HTTP header. This
#-# allows to use the default language of the wiki when the user didn't manually choose a language.
# xwiki.language.preferDefault=0

#-# Force only one of the supported languages to be accepted.


# xwiki.language.forceSupported=0

#---------------------------------------
# Virtual wikis (farm)
#
#-# This parameter allows XWiki to operate in Hosting mode allowing to create multiple wikis having their own
#-# database and responding to different URLs
xwiki.virtual=0

#-# URL to redirect to when a requested wiki does not exist. This should be changed to a real page.
xwiki.virtual.redirect=http://127.0.0.1:9080/xwiki/bin/Main/ThisWikiDoesNotExist

#-# Forbidden names that should not be allowed when creating a new wiki.
# xwiki.virtual.reserved_wikis=

#-# How virtual wikis are mapped to different URLs. If set to 0 (the default),
#-# then virtual wikis have different domain
#-# names, in the format http://wikiname.myfarm.net/. If set to 1, then the domain is
#-# common for the entire farm, but the
#-# path contains the wiki name, in the format http://myfarm.net/xwiki/wiki/wikiname/.
#-# Note that you can configure the "/wiki/" part with xwiki.virtual.usepath.servletpath property.
# xwiki.virtual.usepath=0

#-# Configure the servlet action identifier for url path based multiwiki. It has also to be
#-# modified in web.xml.
# xwiki.virtual.usepath.servletpath=wiki

#---------------------------------------
# URLs
#
#-# The domain name to use when creating URLs to the default wiki. If set, the generated URLs will
#-# point to this server
#-# instead of the requested one. It should contain schema, domain and (optional) port, and the
#-# trailing /. For example:
#-# xwiki.home=http://www.xwiki.org/
#-# xwiki.home=http://wiki.mycompany.net:8080/
# xwiki.home=

#-# The name of the default URL factory that should be used.
# xwiki.urlfactory.serviceclass=com.xpn.xwiki.web.XWikiURLFactoryServiceImpl

#-# Force the protocol to use in the generated URLs. The right value is taken from the request URL,
#-# so setting this
#-# is not recommended in most cases.
#-# For example:
#-# xwiki.url.protocol=https
# xwiki.url.protocol=

#-# The name of the webapp to use in the generated URLs. The right value is taken from the
#-# request URL, so setting this
#-# is not recommended in most cases. If set, the value should contain a trailing /, but not a
#-# leading one. For example:
#-# xwiki.webapppath=xwiki/
# xwiki.webapppath=

#-# The default servlet mapping name to use in the generated URLs. The right value is taken from the request
#-# URL preserving the requested servlet mapping, so setting this is not recommended in most cases.
#-# If set, the value should contain a trailing /, but not a leading one. For example:
#-# xwiki.servletpath=bin/
# xwiki.servletpath=

#-# The fallback servlet mapping name to use in the generated URLs. Unlike xwiki.servletpath, this is the
#-# value used when
#-# the correct setting could not be determined from the request URL. A good way to use this setting
#-# is to achieve short
#-# URLs, see http://platform.xwiki.org/xwiki/bin/Main/ShortURLs
# xwiki.defaultservletpath=bin/

#-# Whether the /view/ part of the URL should be included if the target action is 'view'.
# xwiki.showviewaction=1

#-# The name of the default space. This is displayed when the URL specifies a document,
#-# but not a space, or neither.
# xwiki.defaultweb=Main

#-# Hide the /Space/ part of the URL when the space is the default one. Warning: use 1 to hide, 0 to show.
# xwiki.usedefaultweb=0

#-# The name of the default page of a space. This is displayed when the URL specifies a
#-# space, but not a document, or neither.
# xwiki.defaultpage=WebHome

#-# Hide the /WebHome part of the URL when the document is the default one. Use 0 to hide, 1 to show.
# xwiki.usedefaultaction=0

#---------------------------------------
# Users
#
xwiki.inactiveuser.allowedpages=

#---------------------------------------
# Authentication and authorization
#
#-# Enable to allow superadmin. It is disabled by default as this could be a
#-# security breach if it were set and you forgot about it. Should only be enabled
#-# for recovering the Wiki when the rights are completely messed.
# xwiki.superadminpassword=system

#-# Authentication type. You can use 'basic' to always use basic authentication.
# xwiki.authentication=form

#-# Indicate if the authentication has do be done for each request


#-# 0: the default value, authentication is done only once by session.
#-# 1: the authentication is done for each request.
# xwiki.authentication.always=0

#-# Cookie encryption keys. You SHOULD replace these values with any random string,
#-# as long as the length is the same.
xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

#-# Comma separated list of domains for which authentication cookies are set. This
#-# concerns mostly wiki farms. The exact meaning is that when a user logs in, if
#-# the current domain name corresponding to the wiki ends with one of the entries
#-# in this parameter, then the cookie is set for the larger domain. Otherwise, it
#-# is set for the exact domain name of the wiki.
#-#
#-# For example, suppose the cookiedomains is set to "mydomain.net". If I log in
#-# on wiki1.xwiki.com, then the cookie will be set for the entire mydomain.net
#-# domain, and if I visit wiki2.xwiki.com I will still be authenticated. If I log
#-# in on wiki1.otherdomain.net, then I will only be authenticated on
#-# wiki1.otherdomain.net, and not on wiki2.otherdomain.net.
#-#
#-# So you need this parameter set only for global authentication in a
#-# farm, there's no need to specify your domain name otherwise.
#-#
#-# Example: xwiki.authentication.cookiedomains=xwiki.org,myxwiki.org
xwiki.authentication.cookiedomains=
#-# This allows logout to happen for any page going through the /logout/ action, regardless
#-# of the document or the servlet.
#-# Comment-out if you want to enable logout only for /bin/logout/XWiki/XWikiLogout
#-# Currently accepted patterns:
#-# - /StrutsServletName/logout/ (this is usually /bin/logout/ and is the default setup)
#-# - /logout/ (this works with the short URLs configuration)
#-# - /wiki/SomeWikiName/logout/ (this works with path-based virtual wikis)
xwiki.authentication.logoutpage=(/|/[^/]+/|/wiki/[^/]+/)logout/*

#-# The group management class.


# xwiki.authentication.groupclass=com.xpn.xwiki.user.impl.xwiki.XWikiGroupServiceImpl
#-# Default value for exo:
# xwiki.authentication.groupclass=com.xpn.xwiki.user.impl.exo.ExoGroupServiceImpl

#-# The authentication management class.


# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.xwiki.XWikiAuthServiceImpl
#-# Default value for exo:
# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.exo.ExoAuthServiceImpl
#-# Default value for LDAP:
# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl

#-# The authorization management class.


# xwiki.authentication.rightsclass=com.xpn.xwiki.user.impl.xwiki.XWikiRightServiceImpl

#-# If an unauthenticated user (guest) tries to perform a restricted action, by default the
#-# wiki redirects to the login
#-# page. Enable this to simply display an "unauthorized" message instead, to hide the login form.
# xwiki.hidelogin=false

#-# HTTP status code to sent when the authentication failed.


xwiki.authentication.unauthorized_code=200

#---------------------------------------
# Rendering
#
#-# Disable particular renderers (in the old rendering engine).
#-# Macro mapping
# xwiki.render.macromapping=1
#-# Velocity interpreter
# xwiki.render.velocity=1
#-# Groovy interpreter
# xwiki.render.groovy=1
#-# Plugin rendering
# xwiki.render.plugin=1
#-# Radeox wiki renderer
# xwiki.render.wiki=1
#-# Simple wiki syntax rendering
# xwiki.render.wikiwiki=0

#-# Maximum number of documents to keep in the rendered cache


# xwiki.render.cache.capacity=100

#-# Default target for external links. Use _blank to open external links in a new tab/window.
# xwiki.render.externallinks.defaulttarget=

#---------------------------------------
# Editing
#
#-# Minor edits don't participate in notifications.
# xwiki.minoredit=1
#-# Use edit comments
xwiki.editcomment=1

#-# Hide editcomment field and only use Javascript


# xwiki.editcomment.hidden=0

#-# Make edit comment mandatory


xwiki.editcomment.mandatory=0

#-# Make edit comment suggested (asks 1 time if the comment is empty.
#-# 1 shows one popup if comment is empty.
#-# 0 means there is no popup.
#-# This setting is ignored if mandatory is set
# xwiki.editcomment.suggested=0

#-------------------------------------------------------------------------------------
# LDAP
#-------------------------------------------------------------------------------------
#-# new LDAP authentication service
# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl

#-# Turn LDAP authentication on - otherwise only XWiki authentication


#-# 0: disable
#-# 1: enable
# xwiki.authentication.ldap=1

#-# LDAP Server (Active Directory, eDirectory, OpenLDAP, etc.)


xwiki.authentication.ldap.server=127.0.0.1
xwiki.authentication.ldap.port=389

#-# LDAP login, empty = anonymous access, otherwise specify full dn


#-# {0} is replaced with the username, {1} with the password
xwiki.authentication.ldap.bind_DN=cn={0},department=USER,department=INFORMATIK,department=1230,o=MP
xwiki.authentication.ldap.bind_pass={1}

#-# Force to check password after LDAP connection


#-# 0: disable
#-# 1: enable
xwiki.authentication.ldap.validate_password=0

#-# only members of the following group will be verified in the LDAP
#-# otherwise only users that are found after searching starting from the base_DN
# xwiki.authentication.ldap.user_group=cn=developers,ou=groups,o=MegaNova,c=US

#-# [Since 1.5RC1, XWikiLDAPAuthServiceImpl]


#-# only users not member of the following group can autheticate
# xwiki.authentication.ldap.exclude_group=cn=admin,ou=groups,o=MegaNova,c=US

#-# base DN for searches


xwiki.authentication.ldap.base_DN=

#-# Specifies the LDAP attribute containing the identifier to be used as the XWiki name (default=cn)
# xwiki.authentication.ldap.UID_attr=cn

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]


#-# Specifies the LDAP attribute containing the password to be used "when
#-# xwiki.authentication.ldap.validate_password" is set to 1
# xwiki.authentication.ldap.password_field=userPassword

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]


#-# The potential LDAP groups classes. Separated by commas.
# xwiki.authentication.ldap.group_classes=group,groupOfNames, \
groupOfUniqueNames,dynamicGroup,dynamicGroupAux,groupWiseDistributionList

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]


#-# The potential names of the LDAP groups fields containings the members. Separated by commas.
# xwiki.authentication.ldap.group_memberfields=member,uniqueMember

#-# retrieve the following fields from LDAP and store them in the XWiki user object
#-# (xwiki-attribute=ldap-attribute)
xwiki.authentication.ldap.fields_mapping=last_name=sn,first_name=givenName,email=mail

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# on every login update the mapped attributes from LDAP to XWiki otherwise this happens only
#-# once when the XWiki account is created.
xwiki.authentication.ldap.update_user=1

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# mapps XWiki groups to LDAP groups, separator is "|"
# xwiki.authentication.ldap.group_mapping=XWiki.XWikiAdminGroup=cn=AdminRole,ou=groups,o=MegaNova,c=US|\
# XWiki.Organisation=cn=testers,ou=groups,o=MegaNova,c=US

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# time in s after which the list of members in a group is refreshed from LDAP (default=3600*6)
# xwiki.authentication.ldap.groupcache_expiration=21800

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# - create : synchronize group membership only when the user is first created
#-# - always: synchronize on every login
# xwiki.authentication.ldap.mode_group_sync=always

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# if ldap authentication fails for any reason, try XWiki DB authentication
#-# with the same credentials
xwiki.authentication.ldap.trylocal=1

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# SSL connection to LDAP server
#-# 0: normal
#-# 1: SSL
# xwiki.authentication.ldap.ssl=0

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]


#-# The keystore file to use in SSL connection
# xwiki.authentication.ldap.ssl.keystore=

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]


#-# The java secure provider used in SSL connection
# xwiki.authentication.ldap.ssl.secure_provider=com.sun.net.ssl.internal.ssl.Provider

#---------------------------------------
# Cache
# [DEPRECATED since 1.7M1: this way to configure cache provider is deprecated, you should
#-# use xwiki.properties instead.]
#---------------------------------------
#-# [Since 1.5M2]
#-# The cache component implementation to use as "normal" (can be local or distributed
#-# depending on the implementation) cache component.
# xwiki.cache.cachefactory.hint=jbosscache
#-# [Since 1.5M2]
#-# The cache component to use as local cache component.
# xwiki.cache.cachefactory.local.hint=jbosscache/local

#---------------------------------------
# WYSIWYG Editor configuration
#
#-# You can configure the toolbars you wish to see in the WYSIWYG editor by defining the
#-# xwiki.wysiwyg.toolbars property.
#-# When not defined it defaults to:
# xwiki.wysiwyg.toolbars=texttoolbar, listtoolbar, indenttoolbar, undotoolbar, titletoolbar, \
# styletoolbar, horizontaltoolbar, attachmenttoolbar, macrostoolbar, \
# tabletoolbar, tablerowtoolbar, tablecoltoolbar, linktoolbar

#-# The full list of toolbars includes the one defined above and the following ones:
#-# subtoolbar, findtoolbar, symboltoolbar

#---------------------------------------
# Skins &amp; Templates configuration
#
#-# The default skin to use when there's no value specified in the wiki preferences document.
#-# Note that the default
#-# wiki already specifies a skin, so this setting is only valid for empty wikis.
xwiki.defaultskin=colibri

#-# The default base for skins that don't specify a base skin. This is also the last place where
#-# a skin file is searched
#-# if not found in the more specific skins.
xwiki.defaultbaseskin=albatross

#-# Defines whether title handling should be using the compatibility mode or not. When the compatibility
#-# mode is active, if the document's content first header (level 1 or level 2) matches the document's title
#-# the first header is stripped.
xwiki.title.compatibility=1

#---------------------------------------
# Extensions
#

#-# List of active plugins.


xwiki.plugins=\
com.xpn.xwiki.monitor.api.MonitorPlugin,\
com.xpn.xwiki.plugin.skinx.JsSkinExtensionPlugin,\
com.xpn.xwiki.plugin.skinx.JsSkinFileExtensionPlugin,\
com.xpn.xwiki.plugin.skinx.CssSkinExtensionPlugin,\
com.xpn.xwiki.plugin.skinx.CssSkinFileExtensionPlugin,\
com.xpn.xwiki.plugin.feed.FeedPlugin,\
com.xpn.xwiki.plugin.ldap.LDAPPlugin,\
com.xpn.xwiki.plugin.google.GooglePlugin,\
com.xpn.xwiki.plugin.flickr.FlickrPlugin,\
com.xpn.xwiki.plugin.mail.MailPlugin,\
com.xpn.xwiki.plugin.packaging.PackagePlugin,\
com.xpn.xwiki.plugin.query.QueryPlugin,\
com.xpn.xwiki.plugin.svg.SVGPlugin,\
com.xpn.xwiki.plugin.charts.ChartingPlugin,\
com.xpn.xwiki.plugin.fileupload.FileUploadPlugin,\
com.xpn.xwiki.plugin.image.ImagePlugin,\
com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin,\
com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl,\
com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPlugin,\
com.xpn.xwiki.plugin.autotag.AutoTagPlugin,\
com.xpn.xwiki.plugin.lucene.LucenePlugin,\
com.xpn.xwiki.plugin.diff.DiffPlugin,\
com.xpn.xwiki.plugin.rightsmanager.RightsManagerPlugin,\
com.xpn.xwiki.plugin.jodatime.JodaTimePlugin,\
com.xpn.xwiki.plugin.scheduler.SchedulerPlugin,\
com.xpn.xwiki.plugin.mailsender.MailSenderPlugin,\
com.xpn.xwiki.plugin.activitystream.plugin.ActivityStreamPlugin, \
com.xpn.xwiki.plugin.watchlist.WatchListPlugin, \
com.xpn.xwiki.wysiwyg.server.plugin.WysiwygPlugin, \
com.xpn.xwiki.plugin.tag.TagPlugin
#-# Enable light monitoring of the wiki performance. Records various statistics, like
#-# number of requests processed,
#-# time spent in rendering or in the database, medium time for a request, etc. Disable for a
#-# minor increase of performance and a bit of memory.
# xwiki.monitor=1

#-# Maximum number of last requests to remember.


# xwiki.monitor.lastlistsize=20

#-# Stats configuration allows to globally activate/deactivate stats module (launch storage thread,
#-# register events...).
#-# Enabled by default.
# xwiki.stats=1

#-# When statistics are globally enabled, storage can be enabled/disabled by wiki using the XWikiPreference
property "statistics".
#-# Note: Statistics are disabled by default for improved performances/space.
xwiki.stats.default=0

#-# It is also possible to choose a different stats service to record statistics separately from XWiki.
# xwiki.stats.class=com.xpn.xwiki.stats.impl.XWikiStatsServiceImpl

#-# This parameter will activate the eXo Platform integration


xwiki.exo=0

#-# GraphViz plugin configuration. The GraphViz plugin is not configured by default.
#-# To enable it, add "com.xpn.xwiki.plugin.graphviz.GraphVizPlugin" to the list of plugins
#-# in the xwiki.plugins property.
#-# Uncomment and set the locations of the Dot and Neato executables
# xwiki.plugin.graphviz.dotpath=c:/Program Files/ATT/GraphViz/bin/dot.exe
# xwiki.plugin.graphviz.neatopath=c:/Program Files/ATT/GraphViz/bin/neato.exe

xwiki.plugin.laszlo.baseurl=/openlaszlo/xwiki/
xwiki.plugin.laszlo.path=c:/Program Files/Apache Software Foundation/Tomcat 5.0/webapps/openlaszlo/xwiki/

xwiki.plugin.image.cache.capacity=30

#-# Calendar Prev/Next Month bounds.


#-# The calendar generates links to the previous/next months for a limited range, by default 6
#-# months back and 12 months
#-# after. A value of 0 means that there is no limit in that direction.
# xwiki.calendar.bound.prev=6
# xwiki.calendar.bound.next=12

#-# Lucene search engine


#-# Location where to place the lucene index files. The default is the "lucene" subdirectory in the
container's "work"
#-# diectory. Change it if you want to store indexes in another place.
# xwiki.plugins.lucene.indexdir=/usr/local/xwiki/lucene
#-# The text analyzer to use for indexing.
# xwiki.plugins.lucene.analyzer=org.apache.lucene.analysis.standard.StandardAnalyzer

#-# The number of seconds to wait between reindexes. A smaller value ensures that new documents
#-# will be indexed faster,
#-# but with a minor performance reduction. Adjust according to your wiki load.
# xwiki.plugins.lucene.indexinterval=20

#-# The maximum size of the indexing queue. After this limit is reached, the reindex thread
#-# will have to wait until the
#-# queue is consumed. Note that this does not affect documents submitted through the notification
#-# mechanism, only the
#-# full reindex option.
# xwiki.plugins.lucene.maxQueueSize=1000

#-# [Since 2.0RC1]


#-# Activity Stream plugin.
#-# The Activity Stream plugin stores data in a dedicated table in the database. In virtual mode
#-# each wiki has it's own database, the plugin can be configured to store its data into the database
#-# corresponding to the wiki, into the main
#-# database (default: xwiki) or both. If the wiki is not running in virtual mode these options
#-# will not have any
#-# effect. These options should not be both set to 0 (in this case the local store will be forced).
#-# Important note: disabling storage in the main store will prevent the watchlist from retrieving
#-# events from subwikis.
#-#
#-# Default: 1
# xwiki.plugin.activitystream.uselocalstore=1
#-#
#-# Default: 1
# xwiki.plugin.activitystream.usemainstore=1

#-# Number of days the events should be kept (0 or any negative value: infinite duration)
#-# Note: if this value is greater than 0 a scheduler job will be created, this job will then be
#-# fired every week to
#-# delete events older than the configured value.
#-# Default: 0
# xwiki.plugin.activitystream.daystokeepevents=0

#---------------------------------------
# Misc
#
#-# Temporary directory where XWiki can put files (during exort and upload, for example).
# xwiki.temp.dir=/tmp/xwiki
#-# XWiki work directory
# xwiki.work.dir=/usr/local/xwiki

xwiki.work.dir=work

Ejemplo de xwiki.properties
# This is the new XWiki configuration file. In the future it'll replace the old
# xwiki.cfg file. However right now it's only used by some XWiki components.
# As time progresses more and more component will get their configurations from
# this file.

#-------------------------------------------------------------------------------------
# Core
#-------------------------------------------------------------------------------------

#-# [Since 1.8RC2]


#-# Specifies the default syntax to use when creating new documents.
#-# Default value is xwiki/2.0.
core.defaultDocumentSyntax = xwiki/2.0

#-------------------------------------------------------------------------------------
# Rendering
#-------------------------------------------------------------------------------------

#-# [Since 1.8RC2]


#-# Specifies how links labels are displayed when the user doesn't specify the label explicitely.
#-# Valid values:
#-# %w: wiki name
#-# %s: space name
#-# %p: page name
#-# %P: page name with spaces between camel case words, i.e. "My Page" if
#-# the page name is "MyPage"
#-# %t: page title
#-#
#-# Note that if the page title is empty or not defined then it defaults to %p.
#-# This is also the case if the title cannot be retrieved for the document.
#-#
#-# The default is "%p". Some examples: "%s.%p", "%w:%s.%p".
# rendering.linkLabelFormat = %p

#-# [Since 2.0M3]


#-# Overrides default macro categories (Each macro has a default category already defined,
#-# for example "presentation" for the Table of Contents Macro).
#-#
#-# Ex: To redefine the macro category for the TOC macro so that it'd be in
#-# the "My Category" category + redefine the category for the Script Macro to
#-# be "My Other Category", you'd use:
# rendering.macroCategories = toc:My Category
# rendering.macroCategories = script:My Other Category

#-------------------------------------------------------------------------------------
# Cache
#-------------------------------------------------------------------------------------

#-# [Since 1.7M1]


#-# The standard cache component implementation to use (can be local or distributed
#-# depending on the implementation).
#-# The default standard cache implementation is JBoss Cache.
# cache.defaultCache=jbosscache

#-# [Since 1.7M1]


#-# The local cache implementation to use.
#-# The default local cache implementation is JBoss Cache.
# cache.defaultLocalCache=jbosscache/local

#----------------------------------------------------------------------------------
# Settings for the OpenOffice server instance consumed by the OfficeImporter plugin
#----------------------------------------------------------------------------------

#-# [Since 1.9M2]


#-# Type of the openoffice server instance used by officeimporter plugin.
#-# 0 - Internally managed server instance. (Default)
#-# 1 - Externally managed (local) server instance.
# openoffice.serverType=0

#-# [Since 1.9M2]


#-# Port number used for connecting to the openoffice server instance.
#-# Default port is 8100
# openoffice.serverPort=8100

#-# [Since 1.9M2]


#-# If the openoffice server should be started / connected upon XE start.
#-# Default value is false
# openoffice.autoStart=false

#-# [Since 1.8RC3]


#-# Path to openoffice installation (serverType:0 only).
#-# If no path is provided, a default value will be calculated based on the operating environment.
# openoffice.homePath=/opt/openoffice.org3/

#-# [Since 1.8RC3]


#-# Path to openoffice execution profile (serverType:0 only).
#-# If no path is provided, a default value will be calculated based on the operating environment.
# openoffice.profilePath=/home/user/.openoffice.org/3

#-# [Since 1.8RC3]


#-# Maximum number of simultaneous conversion tasks to be handled by a single
#-# openoffice process (serverType:0 only).
#-# Default value is 50
# openoffice.maxTasksPerProcess=50

#-# [Since 1.8RC3]


#-# Timeout for conversion tasks (in miliseconds) (serverType:0 only).
#-# Default value is 30 seconds
# openoffice.taskExecutionTimeout=30000

#-------------------------------------------------------------------------------------
# Velocity
#-------------------------------------------------------------------------------------

#-# [Since 2.0M1]


#-# Velocity Tools that will be available from your scripts. The format is
#-# velocity.tools.<name under which it'll be available in the context> = <class name>
#-# Default values (no need to add them)
#-# velocity.tools = listtool = org.apache.velocity.tools.generic.ListTool
#-# velocity.tools = numbertool = org.apache.velocity.tools.generic.NumberTool
#-# velocity.tools = datetool = org.apache.velocity.tools.generic.DateTool
#-# velocity.tools = mathtool = org.apache.velocity.tools.generic.MathTool
#-# velocity.tools = sorttool = org.apache.velocity.tools.generic.SortTool
#-# velocity.tools = escapetool = org.apache.velocity.tools.generic.EscapeTool
#-# velocity.tools = regextool = org.xwiki.velocity.tools.RegexTool

#-# [Since 2.0M1]


#-# Velocity configuration properties. The format is
#-# velocity.property.<Velocity property name> = <value>
#-# Default values (no need to add them)
#-# velocity.properties = resource.loader = webapp
#-# velocity.properties = directive.set.null.allowed = true
#-# velocity.properties = webapp.resource.loader.class = org.apache.velocity.tools.view.servlet.WebappLoader
#-# velocity.properties = velocimacro.messages.on = false
#-# velocity.properties = resource.manager.logwhenfound = false
#-# velocity.properties = velocimacro.permissions.allow.inline.local.scope = true
#-# velocity.properties = runtime.introspector.uberspect =
org.xwiki.velocity.introspection.ChainingUberspector
#-# velocity.properties = runtime.introspector.uberspect.chainClasses =
org.apache.velocity.util.introspection.SecureUberspector,org.xwiki.velocity.introspection.DeprecatedCheckUbers
pector

#-------------------------------------------------------------------------------------
# Events distribution
#-------------------------------------------------------------------------------------

#-# [Since 2.0M3]


#-# Indicate if the network distribution module is enabled or not.
#-# By default remote events are disabled.
# observation.remote.enabled = false

#-# [Since 2.0M3]


#-# The list of events communication channels to start when the application starts.
#-# By default no channel is configured.
#-#
#-# The default remote event distribution implementation is using JGroups and you'll need
#-# to drop your JGroups channel
#-# xml files in the WEB-INF/observation/remote/jgroups/ directory. There's a README
#-# file in that directory with more
#-# information.
#-# Example: observation.remote.channels = public, cluster

#-# [Since 2.0M4]


#-# The implementation of network adapter to use.
#-# The default is jgroups.
#-#
#-# By default obnly jgroups is provided. To add one implements NetworkAdaptor componenet
#-# interface. The identifier provided in the configuration is matched with the component
#-# role hint.
#-# Example: observation.remote.networkadapter = jgroups

#-------------------------------------------------------------------------------------
# Administration
#-------------------------------------------------------------------------------------

#-# [Since 2.2M2]


#-# Enable captcha: true|false
#-#
#-# Captcha is disabled by default.
#-# Example: captcha.enabled = true
Security

Admin password
Asegurarse de cambiar la contraseña o eliminar a este usuario.

Cuenta Superadmin
Porqué es especial:
• No está registrada en la base de datos.
• No puede ser modificada de ninguna forma.
• Tiene completo acceso aunque los permisos hayan sido alterados.
Por esto no debe ser habilitada durante demasiado tiempo.
Para habilitarla en xwiki.cfg, descomentando xwiki.superadminpassword=system, recuerde
reiniciar el contenedor de XWiki tras los cambios.
Puede ser útil cuando se es incapaz de loguearse, se han borrado las cuentas de administrador...

Claves para encriptar las Cookies


Cuando un usuario decide que su navegador recuerde su acceso a la wiki esta le enviará una cifrada a
la que nadie pueda acceder. El encriptado se basa en dos parámetros del fichero xwiki.cfg.
Es importante cambiarlas:
xwiki.authentication.validationKey
xwiki.authentication.encryptionKey
En futuras versiones se pretende generarlas basadas en números aleatorios con una semilla
dependiente de la maquina física en el momento de la instalación (ver el siguiente concepto para más
detalles).

Administración de Usuarios
Estas instrucciones asumen que se están usando las máscaras Albatross o Toucan (capturas de
pantalla de Toucan).

Añadiendo usuarios
• Entrar como administrador, ir a Administración, y entrar en Usuarios.
• Pulsar en Añadir y rellenar los datos.
Cambiar la contraseña a los usuarios
• Entrar como administrador, ir a Administración, y entrar en Usuarios.
• Pulsar sobre el usuario, luego añadir a la URL ?xpage=passwd.

Cambiar la contraseña del usuario logueado


• Ir al perfil tomando el enlace que queda arriba a la derecha, y hacer clic en Cambiar
contraseña.

Editar un usuario existente


• Entrar como administrador, ir a Administración, y entrar en Usuarios.
• Pulsar sobre el usuario, o sobre el icono de edición.
Eliminar un usuario
• Entrar como administrador, ir a Administración, y entrar en Usuarios.
• Pulsar sobre el icono de borrar de la fila donde este el usuario, no se puede realizar sobre el
usuario logueado.

Das könnte Ihnen auch gefallen