Saltar al contenido principal

Distribución

Has escrito una gran extensión y ahora quieres que todo el mundo pueda usarla. Este documento te llevará a través del proceso de distribución, desde la creación de un repositorio Git para tu extensión, hasta su publicación en Packagist.

Configurar Git

Lo primero que tienes que hacer es configurar un sistema de control de versiones (VCS). El VCS más popular es Git. En esta guía usaremos Git, así que asegúrate de tenerlo instalado antes de continuar. Si no tienes muchos conocimientos sobre Git, puedes consultar estos recursos de aprendizaje.

Después de haber instalado Git, necesitarás inicializar tu repositorio. Puedes usar git init en la línea de comandos si te sientes cómodo, o usar una herramienta GUI como SourceTree o GitKraken.

A continuación, necesitarás una cuenta en un servidor de alojamiento de Git, siendo los más populares GitHub y GitLab. Estos te indicarán cómo conectar tu repositorio local con el repositorio "remoto" en línea.

Etiquetar una versión

Como vas a publicar esta extensión, querrás asegurarte de que la información está actualizada. Tómese un minuto para revisar composer.json y asegurarse de que el nombre del paquete, la descripción y la información de la extensión Flarum son correctos. Se recomienda tener un archivo README.md en su repositorio para explicar qué es la extensión, así que cree uno si aún no lo ha hecho.

Cuando esté listo para publicar, envíe los archivos de su extensión al repositorio y etiquete su primera versión:

git tag v0.1.0
git push && git push --tags

Publicar en Packagist

Los paquetes de Composer se publican en un repositorio de Composer, normalmente Packagist. Necesitarás una cuenta para proceder.

Si esta es la primera versión que publicas de tu extensión, tendrás que enviar tu paquete utilizando la URL de su repositorio público. Si tu extensión se encuentra en GitHub, esta URL será algo así como https://github.com/AUTHOR/NAME.git.

Future Releases

You can set up Packagist to auto-update packages. Then for future releases, all you will need to do with Git is commit, tag, and push it to the remote server.

Promover su extensión

Lo más probable es que quieras crear una discusión en la Comunidad Flarum en la etiqueta de extensiones. Otras personas pueden instalar su extensión usando el siguiente comando:

composer require vendor/package