Cómo personalizar el correo web de Roundcube
Última modificación: 10 de agosto de 2021
Visión general
Advertencia:
- Este documento es solamente válido para cPanel & WHM versión 11.46 a 56. Las personalizaciones que utilizan este método no funcionan en cPanel & WHM versión 58 y posteriores, porque estas versiones envían Roundcube como un RPM.
- Debido a que cPanel, LLC no desarrolla Roundcube, el soporte técnico de cPanel no puede ayudar con la personalización.
- Para personalizar Roundcube para cPanel & WHM versión 58 y posteriores, lea nuestro Cómo crear e instalar RPM personalizados en sistemas Red Hat documentación.
- cPanel, LLC hace no admite personalizaciones de la experiencia del usuario de Roundcube.
Puede actualizar y personalizar la aplicación de correo web Roundcube.
Ruta y nombres de archivo para la base de datos
La base de datos SQLite utiliza la siguiente ruta y nombre de archivo, donde username
representa un nombre de usuario de la cuenta de cPanel y domain
representa un nombre de dominio:
/home/username/etc/domain/username.rcube.db
Además, la base de datos aplica las siguientes convenciones de nomenclatura, donde el nombre de usuario representa un nombre de usuario de la cuenta de cPanel:
Nombre del archivo | Descripción | Ejemplo |
---|---|---|
/home/username/etc/domain/username.rcube.db.unixtimestamp | Un archivo de respaldo con una marca de tiempo Unix. | username.rcube.db.1495814375 |
/home/username/etc/domain/username.rcube.db.latest | Un enlace simbólico a la última copia de seguridad de Roundcube. | username.rcube.db.latest |
/home/username/etc/domain/username.rcube.db.YYYYMMDDHHMMSS.sqlite2 | Un archivo de respaldo SQLite v2. | username.rcube.db.20170523105040.sqlite2 |
Actualizaciones de Roundcube
Advertencia:
Porque el /usr/local/cpanel/bin/update-roundcube
texto solamente conserva las últimas cuatro copias de seguridad, la ejecución continua de la /usr/local/cpanel/bin/update-roundcube
La secuencia de comandos puede provocar la pérdida de datos. Nosotros fuertemente recomienda que mantenga copias de seguridad externas y evite las copias de seguridad continuas de las instalaciones de Roundcube no operativas.
El método que usa cPanel & WHM para actualizar Roundcube afecta sus personalizaciones. cPanel & WHM utiliza el siguiente proceso para actualizar Roundcube:
El sistema ejecuta el
/scripts/upcp
script para actualizar cPanel y WHM.los
/scripts/upcp
script ejecuta el/usr/local/cpanel/install/webmail
texto.los
/usr/local/cpanel/install/webmail
script ejecuta el/usr/local/cpanel/bin/update-roundcube
texto.los
/usr/local/cpanel/bin/update-roundcube
El script ejecuta el siguiente comando para eliminar la instalación actual de Roundcube:rm -rf /usr/local/cpanel/base/3rdparty/roundcube
los
/usr/local/cpanel/bin/update-roundcube
script extrae el tarball fuente apropiado al/usr/local/cpanel/base/3rdparty/
directorio.Nota:
Durante este paso, el
/usr/local/cpanel/bin/update-roundcube
El script comprueba la existencia del/var/cpanel/roundcube/install
archivo y realiza una de las siguientes acciones:los
/usr/local/cpanel/bin/update-roundcube
El script cambia la propiedad de la instalación de Roundcube a laroot
usuario y elwheel
grupo.los
/usr/local/cpanel/bin/update-roundcube
El script comprueba la existencia del/var/cpanel/roundcube
/ instalar archivo.los
/usr/local/cpanel/bin/update-roundcube
El script extrae los valores de configuración de MySQL® de la configuración del sistema.los
/usr/local/cpanel/bin/update-roundcube
script hace una copia de seguridad de la base de datos MySQL de Roundcube en el/var/cpanel/roundcube/roundcube.backup.sql.currenttimestamp
archivo, dondecurrenttimestamp
representa el momento en el que se ejecutó el guión.Nota:
los
/var/cpanel/roundcube/
directorio solamente conserva las cuatro copias más recientes de la copia de seguridad de la base de datos de Roundcube.los
/usr/local/cpanel/bin/update-roundcube
script elimina la base de datos Roundcube de MySQL.los
/usr/local/cpanel/bin/update-roundcube
El script actualiza los archivos de configuración de Roundcube y los archivos MySQL con la configuración del servidor.los
/usr/local/cpanel/bin/update-roundcube
El script recrea la base de datos de Roundcube a partir de los archivos MySQL.los
/usr/local/cpanel/bin/update-roundcube
El script recarga la copia de seguridad anterior de la base de datos de Roundcube y finaliza la actualización.
Instalar una instancia personalizada de Roundcube
Hay muchas formas de personalizar Roundcube. Por ejemplo, puede realizar cambios de configuración simples o reemplazar completamente el tarball de Roundcube.
Para obtener instrucciones sobre cómo personalizar Roundcube, lea el Wiki bajoterra.
Dónde guardar un tarball Roundcube personalizado
Durante el paso 2 del procedimiento de instalación de la actualización de Roundcube, el /usr/local/cpanel/bin/update-roundcube
El script comprueba los archivos comprimidos de Roundcube personalizados. Si alguna de estos archivos tarball existen, cPanel & WHM los usa en lugar del tarball provisto por cPanel.
Si el script localiza varios archivos tar, los usa en el siguiente orden, donde RCUBE_VERSION
representa el número de versión de Roundcube:
/var/cpanel/roundcube/roundcube-RCUBE_VERSION-local.tar.gz
– Utilice esta ubicación para un tarball comprimido que desee aplicar a una versión específica de Roundcube./var/cpanel/roundcube/roundcube-RCUBE_VERSION-local.tar
– Utilice esta ubicación para un tarball sin comprimir que desee aplicar a una versión específica de Roundcube./var/cpanel/roundcube/roundcube-local.tar.gz
– Utilice esta ubicación para un tarball comprimido que desee aplicar a Roundcube, independientemente de la versión./var/cpanel/roundcube/roundcube-local.tar
– Utilice esta ubicación para un tarball sin comprimir que desee aplicar a Roundcube, independientemente de la versión.
Ejemplo
Por ejemplo, cPanel & WHM usa el /var/cpanel/roundcube/roundcube-0.4-local.tar.gz
archivo si las siguientes afirmaciones son verdaderas:
- los
/var/cpanel/roundcube/roundcube-local.tar
y/var/cpanel/roundcube/roundcube-0.4-local.tar.gz
existen archivos. - los
/var/cpanel/roundcube/roundcube-0.4-local.tar.gz
archivo coincide con el número de versión que el /usr/local/cpanel/bin/update-roundcube
especifica el script.
Importante:
- El valor que
RCUBE_VERSION
representa en estos lugares debe coincidir con elRCUBE_VERSION
variable que el/usr/local/cpanel/bin/update-roundcube
la secuencia de comandos define. Por ejemplo, si elRCUBE_VERSION
El parámetro es la versión 0.4 en el/usr/local/cpanel/bin/update-roundcube
guion, tu debe guarde su tarball personalizado como elroundcube-0.4-local.tar.gz
nombre del archivo. - Estos tarballs deben extraerse al
/usr/local/cpanel/base/3rdparty/roundcube/
directorio.
Dónde almacenar un archivo de superposición personalizado
El tarball de superposición le permite personalizar atributos específicos de Roundcube, como el uso de una superposición para cambiar gráficos, temas o complementos. También puede contener un archivo de imagen.
La superposición hace no requieren una distribución Roundcube completa. Solo requiere los componentes que desea modificar, porque cPanel & WHM lo superpondrá a la instalación de Roundcube. Sin embargo, la superposición requiere una estructura de directorio que coincida con la /usr/local/cpanel/base/3rdparty/roundcube
estructura de directorio y comienza con el roundcube
nombre.
Después de determinar qué tarball usar para la instalación de origen y extraerlo, el /usr/local/cpanel/bin/update-roundcube
El script comprueba los siguientes directorios. Si el script localiza varios archivos tar, los usa en el siguiente orden, donde RCUBE_VERSION
representa un número de versión de Roundcube:
/var/cpanel/roundcube/overlay.RCUBE_VERSION.tar.gz
– Utilice esta ubicación para una superposición comprimida que desee aplicar a una versión específica de Roundcube./var/cpanel/roundcube/overlay.tar.gz
– Utilice esta ubicación para una superposición comprimida que desee aplicar a Roundcube, independientemente de la versión./var/cpanel/roundcube/overlay.RCUBE_VERSION.tar
– Utilice esta ubicación para una superposición sin comprimir que desee aplicar a una versión específica de Roundcube./var/cpanel/roundcube/overlay.tar
– Utilice esta ubicación para una superposición sin comprimir que desee aplicar a Roundcube, independientemente de la versión.
Importante:
El valor de la RCUBE_VERSION
variable debe coincidir con el número de versión que el /usr/local/cpanel/bin/update-roundcube
especifica el script.