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 esfalse.
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 de versiones
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.