❤
npm
Sign UpSign In

wporg-api-client

1.0.1 • Public • Published

WpOrg: Node.js Client

WordPress.org Client Library for Node.js

Installation

npm i wporg-api-client

Note: add --save if you are using npm < 5.0.0

This library exposes methods for all the APIs listed here: https://codex.wordpress.org/WordPress.org_API

Examples

Fetch All Plugins List

const { getPluginsList } = require("wporg-api-client");

const fetchPluginsList = async () => {
	let pluginsList = {};

	try {
		pluginsList = await getPluginsList();
		console.log(pluginsList, "pluginsList");
	} catch (error) {
		console.log(error.message, "error");
	}
};

fetchPluginsList();

Get Plugin Downloads Count

const { getPluginDownloads } = require("wporg-api-client")

const fetchPluginDownloads = async (plugin_slug) => {
	let downloadsCount = 0;

	try {
		const apiResponse = await getPluginDownloads(plugin_slug);

		downloadsCount = apiResponse.data

		console.log(downloadsCount, "downloadsCount");
	} catch (error) {
		console.log(error.message, "error");
	}
}

fetchPluginDownloads("contact-form-7")

Table of contents:

Note: Params marked with asterisk(*) are required.

Core

  • Get Core Translation

    Available API versions: 1.0

     getCoreTranslations(wp_version, api_version)

    Note: wp_version starts from 4.0

    Usage

     getCoreTranslations('4.9.5')

  • Get Core Version Info

    Available API versions: 1.7

     getCoreVersionInfo(wp_version, locale, api_version)

    Usage

     getCoreVersionInfo('4.0.1', 'eu')

  • Get Core Credit Details

    Available API versions: 1.1

     getCoreCreditDetails(wp_version, locale, api_version)

    Usage

     getCoreCreditDetails('4.0.1', 'eu')

  • Get Core Checksums

    Available API versions: 1.0

     getCoreChecksums(wp_version*, locale, api_version)

    Usage

     getCoreChecksums('5.5.1', 'eu')

  • Get Browser Info

    Available API versions: 1.1

     getBrowserInfo(useragent*)

    Usage

     getBrowserInfo('Chrome/86.0')

  • Get Core Version Stability Info

    Available API versions: 1.0

     getCoreVersionStabilityInfo(wp_version, api_version)

    Usage

     getCoreVersionStabilityInfo() //returns all versions info


 getCoreVersionStabilityInfo('4.6.20')	//returns specific version info

  • Get Core Statistics

    Available API versions: 1.0

     getCoreStats(api_version)

    Usage

     getCoreStats()

Plugins

  • Filters list

    • search(string): Textual search, using a free-form string

    • tag('string' | 'array'): Return themes with a specified tag or set of tags(array of strings)

    • author(string): WordPress.org username of the author, pass this filter to return plugins authored by them

    • page(number): page number default: 1

    • per_page(number): Plugins to show per page default: 24

    • browse(string): Predefined themes ordering. Possible values are

      • popular: Plugins ordered by popularity
      • featured: Set of featured plugins
      • updated: Recently updated plugins
      • new: Latest plugins

  • Get plugins list

    Available API versions: 1.1, 1.2

     getPluginsList(filters, api_version)

    Usage

     getPluginsList()

 getPluginsList({
 	tag: ['photography', 'blue'],
 	browse: 'popular',
 	page: 1,
 	per_page: 10,
 	//... other filters
 })

  • Filter Plugins By

    Available API versions: 1.1, 1.2

     filterPluginsBy(filter_key*, filter_value*, page, per_page, api_version)

    Usage

     filterPluginsBy('search', 'buddypress', 1, 5)
 filterPluginsBy('tag', ['popup', 'slideshow'])
 filterPluginsBy('author', 'wordpressdotorg', 2, 3)
 filterPluginsBy('browse', 'popular')

  • Get Plugins Info

    Available API versions: 1.1, 1.2

     getPluginInfo(plugin_slug, api_version)

    Usage

     getPluginInfo('wordpress-seo');

  • Get Plugin Hot Tags List

    Available API versions: 1.1, 1.2

     getPluginHotTagsList(api_version)

    Note: tags_count is not implemented in the original api yet

    Usage

     getPluginHotTagsList()

  • Get Plugin Translations

    Available API versions: 1.0

     getPluginTranslations(slug, plugin_version, api_version)

    Usage

     getPluginTranslations('classic-editor', '1.5');

  • Get Plugin Downloads

    Available API versions: 1.0

     getPluginDownloads(plugin_slug*, limit, api_version)

    limit: Downloads in last {limit} days

    Usage

     getPluginDownloads('classic-editor', 7)

  • Get Plugin Statistics

     getPluginStats(plugin_slug*, api_version)

    Usage

     getPluginStats('classic-editor')

Themes

  • Filters list

    • search(string): Textual search, using a free-form string

    • tag('string' | 'array'): Return themes with a specified tag or set of tags(array of strings)

    • theme(string): Slug of a specific theme to return

    • author(string): WordPress.org username of the author, pass this filter to return themes authored by them

    • page(number): page number default: 1

    • per_page(number): Themes to show per page default: 24

    • browse(string): Predefined themes ordering. Possible values are

      • popular: Themes ordered by popularity
      • featured: Set of featured themes
      • updated: Recently updated themes
      • new: Latest themes

  • Get Themes List

    Available API versions: 1.1, 1.2

     getThemesList(filters, api_version)

    Usage

     getThemesList()

 getThemesList({
 	tag: ['photography', 'blue'],
 	browse: 'popular',
 	page: 1,
 	per_page: 10,
 	//... other filters
 })

  • Filter Themes By

    Available API versions: 1.1, 1.2

     filterThemesBy(filter_key*, filter_value*, page, per_page, api_version)

    Usage

     filterThemesBy('search', 'grid', 1, 15)

 filterThemesBy('tag', ['photography', 'blue'])

 filterThemesBy('theme', 'gridmag')

 filterThemesBy('author', 'wordpressdotorg', 2, 3)

 filterThemesBy('browse', 'popular')

  • Get Theme Info

    Available API versions: 1.1, 1.2

     getThemeInfo(theme_slug, api_version)

    Usage

     getThemeInfo('simple-grid')

  • Get Popular Theme Tags

    Available API versions: 1.1, 1.2

     getPopularThemeTags(tags_count, api_version)

    Usage

     getPopularThemeTags()

 getPopularThemeTags(5)

  • Get Theme Translations

    Available API versions: 1.0

     getThemeTranslations(theme_slug*, theme_version, api_version)

    Usage:

     getThemeTranslations('grocery-store', '1.0.2')

Events

  • Get Upcoming WordCamps and meetups details, filterable by location.

    • Filters list

      Main Filters

      • location(string):

      • latitude(number | string) and longitude(number | string)

      • ip(string)

      • country(string): Country name

      Filters To Be Used In Conjunction With Others

      • timezone(string)

      • number(number): No of events to show

      • locale(string)

      getEventDetails(params, api_version)

      Usage

      getEventDetails({ country: 'IT' });

getEventDetails({ ip: '136.0.16.1' })

getEventDetails({
	latitude: '41.900001525879'
	longitude: '12.479999542236'
})

getEventDetails({ location: 'Australia' })

getEventDetails({ number:5, location:'Australia' })

Others

  • Get Statistics of Php, MySql and Wordpress

    Available API versions: 1.0

     getStats(type, api_version)

    Usage

     getStats('php')

 getStats('mysql')

 getStats('wordpress')

  • Generate Secret Key

    Available API versions: 1.1

     generateSecretKey(api_version)

    Usage

     generateSecretKey()

  • List of popular import plugins in the WordPress Plugin Directory used by Tools → Import Screen.

    Available API version: 1.1

     getPopularImportPlugins(api_version)

    Usage

     getPopularImportPlugins()

Dependents (0)

Package Sidebar

Install

npm i wporg-api-client

Repository

github.com/rtCamp/wporg-api-client

Homepage

github.com/rtCamp/wporg-api-client#readme

Weekly Downloads

20

Version

1.0.1

License

MIT

Unpacked Size

66.4 kB

Total Files

21

Last publish

Collaborators

  • gagan0123
  • rtbot
  • sayed.taqui
  • m.radhe
  • rahul286
  • imranhsayed
  • mrrobot47
  • shubuu97
Try on RunKit
Report malware