GitHub Release Downloads

Descripción

GitHub Release Downloads te permite obtener el recuento de descargas, enlaces y más información de las versiones de los repositorios de GitHub.

Contador de descargas

El shortcode es [grd_count]. Devuelve un número, el cual corresponde a la suma de todas las descargas de las versiones seleccionadas. De esta forma, es posible obtener por ejemplo el número de descargas totales para un repositorio de GitHub.

Atributos

  • user: el nombre de usuario de GitHub.
  • repo: el nombre del repositorio de GitHub.
  • latest: solo obtiene información de la última versión publicada en el repositorio.
  • tag: solo obtiene información de la versión con la etiqueta especificada.
  • prereleases: incluye borradores y prelanzamientos. El valor por defecto es false.

Ejemplos

  • Descargas totales del repositorio: [grd_count user="IvanRF" repo="MassiveFileRenamer"]
  • Descargas de la última versión: [grd_count user="IvanRF" repo="MassiveFileRenamer" latest="true"]
  • Descargas de una versión específica: [grd_count user="IvanRF" repo="MassiveFileRenamer" tag="v1.6.0"]

Nota: user y/o repo se pueden omitir si se establecieron los valores por defecto.

Lista de descargas

El shortcode es [grd_list]. Devuelve una lista HTML de las versiones seleccionadas, incluyendo la etiqueta de la versión, la descripción y la lista de archivos que pueden descargarse, como los activos de la versión o el código fuente. En cuanto al diseño, se proveen selectores de clase (p. ej.: release-downloads-header, release-name, etc.).

Atributos

  • user, repo, latest, tag, prereleases: misma definición que arriba.
  • hide_description: oculta la descripción de la versión.
  • hide_size: oculta la información del tamaño del archivo.
  • hide_downloads: oculta la información del número de descargas.
  • downloads_suffix: se puede utilizar para traducciones. El valor por defecto es " downloads".
  • hide_source_code: oculta el enlace de descarga para el código fuente.

Ejemplos

  • Todas las descargas del repositorio: [grd_list user="IvanRF" repo="MassiveFileRenamer"]
  • Descargas de la última versión: [grd_list user="IvanRF" repo="MassiveFileRenamer" latest="true"]
  • Descargas de una Release específica: [grd_list user="IvanRF" repo="MassiveFileRenamer" tag="v1.5.6"]
  • Tamaño de archivos oculto: [grd_list user="IvanRF" repo="MassiveFileRenamer" hide_size="true"]
  • Número de descargas oculto: [grd_list user="IvanRF" repo="MassiveFileRenamer" hide_downloads="true"]
  • Cambio del sufijo para descargas: [grd_list user="IvanRF" repo="MassiveFileRenamer" downloads_suffix="descargas"]

Los atributos de tipo booleano pueden tomar cualquiera de los siguientes valores: «1», «true», «on», «yes»; o «0», «false», «off», «no».

Última versión

El shortcode es [grd_latest_version]. Devuelve la etiqueta de la última versión publicada en el repositorio.
Para etiquetas con valores como «v1.6.0», devuelve «1.6.0» como el número de versión.

Atributos

  • user, repo, prereleases: misma definición que arriba.

Ajustes

Dentro del menú Ajustes de WordPress se encuentra la página de opciones GitHub Release Downloads. En esta página se pueden establecer los valores para el nombre de usuario y el nombre del repositorio de GitHub que se utilizarán por defecto en los shortcodes.

Si se definen ambos valores, los shortcodes se pueden utilizar sin atributos (por ejemplo: [grd_count]) , ya que se usarán los valores por defecto para user y repo.
Los valores de los atributos tienen prioridad sobre los valores por defecto. Por ejemplo, [grd_count repo="MyRepo"] utilizará el nombre de usuario por defecto y el repositorio especificado en el shortcode.

Capturas

  • Ejemplo de [grd_count]. Aquí se utiliza para obtener el número de descargas totales.
  • Ejemplo de [grd_list]. Aquí lista todas las versiones disponibles y sus descargas para un repositorio.
  • Página de opciones de «GitHub Release Downloads».

Instalación

  1. Sube la carpeta github-release-downloads al directorio /wp-content/plugins/
  2. Activa el plugin desde el menú «Plugins» de WordPress

Preguntas frecuentes

Encontrarás más información en ivanrf.com.

Reseñas

3 de septiembre de 2016
Hi Ivan - It is great thought developing a plugin like this. But it didnt worked for me . Could you please help me ? 1. Installed activated 2. In settings page I didnt put any username and repo info 3. I used the shorcode directly showed in examples section like below - [grd_list user="IvanRF" repo="MassiveFileRenamer" latest="true"] it throws me an error says invalid repo. I want to display the repo info of other users. Is it possible ? <Jan21-2016> Latest version is working fine. Thank You
Leer todas las 3 reseñas

Colaboradores y desarrolladores

«GitHub Release Downloads» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«GitHub Release Downloads» ha sido traducido a 2 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «GitHub Release Downloads» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

2.3.1

  • Añadida cabecera de autorización HTTP, ya que el parámetro de consulta access_token está obsoleto.
  • Corrección menor de una advertencia PHP.

2.3.0

  • Añade la descripción de la versión, con compatibilidad con Markdown.
  • Añadido enlace de descarga del código fuente de la versión.
  • Añadido atributo para incluir borradores y prelanzamientos.
  • Mejorado el descarte de avisos de administración.

2.2.0

  • Ignora borradores y prelanzamientos para la última versión. Gracias @john30 a por reportar esto.
  • Mejorados los avisos de administración.

2.1.0

  • Mejorada la lista de descargas.

2.0.1

  • Eliminados los «scopes» para el token de acceso.
  • Añadidas notas en «scopes»
  • Añadidos avisos de administración.

2.0.0.1

  • Corregidas algunas cadenas localizadas.

2.0.0

  • Añadido token de acceso para negociar con la API de límite de descarga.
  • Mejorado el manejo de errores. Los errores externos se muestran para identificar las causas raíz.
  • Añadidas notas de ayuda.
  • Movidas las traducciones a translate.wordpress.org.

1.1.0

  • Añadida compatibilidad con i18n para las cadenas y el recuento de descargas.
  • Añadida traducción al español.
  • Añadido enlace de ajustes en la lista de plugins.
  • Añadidos los enlaces «Donar» y «Sígueme».

1.0.1

  • Corrección menor de una advertencia PHP.

1.0

  • Versión inicial.