-
Notifications
You must be signed in to change notification settings - Fork 7
Expand file tree
/
Copy pathreadme.txt
More file actions
98 lines (75 loc) · 4.07 KB
/
readme.txt
File metadata and controls
98 lines (75 loc) · 4.07 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
=== hub2wp ===
Contributors: pbalazs
Tags: github, plugins, installer
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.5.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Browse, install, and update WordPress plugins directly from GitHub repositories.
== Description ==
This plugin allows you to discover WordPress themes and plugins hosted on GitHub by searching repositories with the "wordpress-plugin" topic. You can install and update these plugins directly from your WordPress dashboard, just like plugins from the official WordPress plugin repository.
Features:
* Search WordPress themes and plugins in GitHub repositories.
* Browse and install extensions from private GitHub repositories (requires personal access token with "repo" scope).
* Install themes and plugins with one click.
* Receive update notifications and update with one click.
* Optionally add a personal GitHub access token to increase API rate limits.
* Caching to reduce API requests.
== Installation ==
1. Install the latest GitHub release:
a. With WP-CLI:
`wp plugin install "https://github.com/WP-Autoplugin/hub2wp/archive/refs/tags/$(curl -fsSL https://api.github.com/repos/WP-Autoplugin/hub2wp/releases/latest | php -r '$release = json_decode(stream_get_contents(STDIN), true); echo $release["tag_name"];').zip" --activate`
b. Or download the latest release from GitHub and upload it to your WordPress plugins directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to "Plugins > Add GitHub Plugin" to browse plugins.
4. Go to "Settings > GitHub Plugins" to add an optional personal access token and configure caching.
== WP-CLI ==
Install and track a GitHub plugin so hub2wp can monitor updates for it:
`wp hub2wp plugin install owner/repo --activate`
List tracked plugins:
`wp hub2wp plugin list`
Install and track a GitHub theme too:
`wp hub2wp theme install owner/repo --activate`
List tracked themes:
`wp hub2wp theme list`
Optional flags:
* `--branch=<branch>` to track a specific branch.
* `--no-release-priority` to force branch-based tracking even if releases exist.
* `--token=<token>` to install from a private repository or override the stored hub2wp token for that command.
Manage hub2wp settings with WP-CLI too:
* `wp hub2wp settings set access_token ghp_xxx`
* `wp hub2wp settings set cache_duration 6`
* `wp hub2wp settings get access_token`
* `wp hub2wp settings list`
== Frequently Asked Questions ==
= Do I need a GitHub token? =
No, but you have a higher request limit if you use one.
== Changelog ==
= 1.5.2 =
* Added list of known-incompatible plugins and themes, to exclude them from search results.
* Fix: refresh update transient when clearing cache from settings page.
= 1.5.1 =
* Fix: non-blocking error when trying to install a theme from inside the plugin details modal.
* UI/UX improvements.
= 1.5.0 =
* New: Added WP-CLI support - commands for installing, listing, and managing tracked plugins and themes, as well as hub2wp settings.
* New: Added integration with the Abilities API for WordPress 6.9+ to allow AI agents and automation tools to interact with hub2wp features and manage GitHub-hosted plugins and themes.
* New: Added a structured "skill" for AI coding assistants and autonomous agents to understand how to operate the plugin correctly.
= 1.4.0 =
* New: Use latest release files to check for updates if available, otherwise fall back to the selected branch.
= 1.3.0 =
* New: Added support for monitoring a specified branch for updates in addition to the default branch.
= 1.2.0 =
* New: Added support for themes in addition to plugins.
* New: Added filter link for GitHub plugins on the Plugins page.
* Fix: Use repo name as the plugin or theme slug on installation.
= 1.1.0 =
* New: Added support for private GitHub repositories.
* New: Private repositories tab in plugin browser.
* New: Settings page UI for managing repositories / monitored plugins.
= 1.0.1 =
* Fix: Update plugin data saved in the activation hook.
* Fix: Use the last commit date from the default branch as the plugin's last updated date.
= 1.0.0 =
* Initial release.