Por
En WordPress

GitHub Release Downloads permite obtener la cantidad de descargas, links y más información de las Releases de un repositorio de GitHub.

El plugin añade los siguientes shortcodes a WordPress:

Número de descargas

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

AtributosDescripción
userel nombre de usuario de GitHub
repoel nombre del repositorio de GitHub
latestsólo obtiene información de la última Release publicada en el repositorio
tagsólo obtiene información de la Release con el tag especificado
Ejemplos
Descargas totales del repositorio[grd_count]
[grd_count user="IvanRF" repo="MassiveFileRenamer"]
Descargas de la última Release[grd_count user="IvanRF" repo="MassiveFileRenamer" latest="true"]
Descargas de una Release 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. Ver Configuración.

Lista de descargas

El shortcode [grd_list] devuelve una lista HTML para los Releases seleccionados, incluyendo el tag del release y la lista de archivos que pueden ser descargados.

En cuanto al diseño, se proveen selectores class (por ejemplo: release-downloads-header, release-downloads, release-name, release-size, release-download-count).

AtributosDescripción
user, repo, latest, tagmisma definición que arriba
hide_sizeoculta la información del tamaño del archivo
hide_downloadsoculta la información del número de descargas
downloads_suffixse puede utilizar para traducciones. El valor por defecto es " downloads"
Ejemplos
Todas las descargas del repositorio[grd_list]
[grd_list user="IvanRF" repo="MassiveFileRenamer"]
Descargas de la última Release[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 hide_downloads="true"]
Cambio del sufijo para descargas[grd_list downloads_suffix=" descargas"]

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

Los atributos de tipo Boolean pueden tomar cualquiera de los siguientes valores: “1”, “true”, “on”, “yes”; o “0”, “false”, “off”, “no”.

Última versión

El shortcode [grd_latest_version] devuelve el tag de la última Release publicada en el repositorio.

Para tags con valores como “v1.6.0”, devuelve “1.6.0” como el número de versión.

AtributosDescripción
user, repomisma definición que arriba

Configuración

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 los valores por defecto para user y repo serán usados.

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.

Entradas Recomendadas

Deja un comentario