La extensión Git Download Updater es compatible tanto con GitHub como con BitBucket.
Conexión con BitBucket
Para conectar tu sitio web de Easy Digital Downloads con tu cuenta de Bitbucket, necesitarás crear una APLICACIÓN dentro de tu cuenta de Bitbucket y luego añadir la Contraseña de la aplicación y tu nombre de usuario de Bitbucket en la configuración de la extensión.
Para crear una contraseña de aplicación, sigue los pasos a continuación:
- Desde el icono de la rueda dentada en la esquina superior derecha, selecciona Configuración personal de Bitbucket.
- Selecciona Contraseñas de aplicaciones en Gestión de acceso.
- Selecciona Crear contraseña de aplicación.
- Dale a la contraseña de la aplicación un nombre que te ayude a recordar para qué se utiliza.
- In the Permissions section check the boxes for:
- Cuenta > Correo electrónico y Lectura
- Membresía del espacio de trabajo > Lectura
- Proyectos > Lectura
- Repositorios > Lectura
- Copia la contraseña generada en un lugar seguro por ahora. La contraseña solo se muestra esta vez.
Aquí tienes una imagen de todos los permisos requeridos descritos en el paso 5 anterior:
Puedes encontrar más detalles sobre las contraseñas de aplicaciones (incluyendo su uso y revocación) en la documentación de Bitbucket.
Una vez que tengas la nueva contraseña de aplicación, añádela a la página Descargas > Ajustes > Extensiones > Git Updater.
El campo Nombre de usuario es tu nombre de usuario real de Bitbucket (no lo confundas con el correo electrónico de la cuenta). Puedes encontrarlo fácilmente en esta página: https://bitbucket.org/account/settings/ en la sección “Configuración del perfil de Bitbucket”.
Conexión con GitHub
Para usar GitHub, navega a Descargas > Ajustes > Extensiones > Git Updater. Sigue las instrucciones de allí para conectarte a GitHub.
Configuración de una descarga con Git Updater
Configuración de tus archivos de descarga
Una vez que hayas conectado tu sitio web a GitHub o Bitbucket, puedes añadir archivos a tus productos de descarga.
1. El metabox “Archivos de descarga” en la pantalla de edición de la descarga ahora tendrá una casilla de verificación etiquetada como “Obtener descarga de un repositorio git”.
2. Después de uno o dos minutos, aparecerá un nuevo conjunto de campos que te permitirán seleccionar un repositorio.
3. Busca el nombre del repositorio y luego selecciona la etiqueta que deseas utilizar.
Nota: La etiqueta de versión utilizada en Git Updater debe ser una etiqueta git nativa. No analiza versiones de tu archivo readme. Para obtener más información sobre el uso de la función de etiquetas en git, puedes visitar esta guía.
4. Haz clic en “Obtener ahora”. Cuando tu descarga se haya importado correctamente del repositorio git, el botón dirá “Obtenido”.
5. Ahora puedes editar el nombre del archivo y/o zip si lo deseas, o dejarlos como predeterminados. ¡Tu archivo zip está listo!
Cuando esté listo para lanzar una nueva versión, simplemente seleccione la etiqueta que desea utilizar y haga clic en obtener. Una vez completada la obtención, actualice su producto.
Preguntas frecuentes y solución de problemas
¿Cómo excluyo o elimino archivos antes de que se genere el zip?
El actualizador de descargas de Git utiliza la función de 'exportación' de Git para crear el archivo a entregar. Puede usar el archivo `.gitattributes` para determinar qué archivos desea ignorar durante la exportación. Aquí tiene un ejemplo de cómo lo usamos para EDD Core.
Para obtener más detalles sobre cómo usar atributos de git para excluir archivos, vea este tutorial.
Conflicto de actualización entre la versión gratuita y la de pago
Hay dos maneras diferentes de resolver este problema:
- Cambie el nombre y/o el slug de la versión pro. Debido a un matiz en la API de actualización de WordPress, WordPress no puede distinguirlos como plugins separados.
- Añada "wp_override" al tercer parámetro de la clase EDD_SL_PLugin_Updater cuando se instancie, de esta manera:
// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
'version' => '1.0', // current version number
'license' => $license_key, // license key (used get_option above to retrieve from DB)
'item_id' => EDD_SAMPLE_ITEM_ID, // name of this plugin
'author' => 'Easy Digital Downloads', // author of this plugin,
'wp_override' => true
)
);Nota: esto requiere la v1.6.4 de la clase actualizador de plugins.
