, 1 April 1989
333 | Ty Coon, President of Vice
334 |
335 | This General Public License does not permit incorporating your program into
336 | proprietary programs. If your program is a subroutine library, you may
337 | consider it more useful to permit linking proprietary applications with the
338 | library. If this is what you want to do, use the GNU Lesser General
339 | Public License instead of this License.
--------------------------------------------------------------------------------
/README.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | Beaver Brewer
8 |
9 | Contributors: rbenhase
10 | Tags: Beaver Builder, custom modules
11 | Requires at least: 4.3
12 | Tested up to: 4.5
13 |
14 |
15 |
16 | Homebrew for Beaver Builder
17 |
18 | Beaver Brewer extends the Beaver Builder plugin by giving admins the ability to easily install “homebrew” modules. It also enables developers to release their modules in an a la carte fashion (no plugin wrapper needed) and even offer automatic updates to their modules through the Wordpress dashboard. You can download the plugin and download some modules right away to get started.
19 |
20 | Beaver Brewer is in active development and should be considered a Beta at this stage. For this reason, you should be cautious about using it on a Production site. When more features are added to the plugin, an automatic update will appear in your Wordpress plugin admin page.
21 |
22 |
23 |
24 | Overview
25 |
26 | Beaver Builder is a fantastic page builder plugin, and its support for custom modules gives it nearly limitless potential. But as the number of Beaver Builder modules increases, they can become a bit difficult for users (and developers) to manage. Beaver Brewer strives to change all that.
27 |
28 | Many modules. Many developers. One plugin.
29 |
30 | Instead of installing a different Wordpress plugin for every set of Beaver Builder modules you want to use, you can now install a single, lightweight plugin that handles them all. This means that a module developer doesn’t necessarily need to build out an entire plugin wrapper for his/her project, and this translates into lower overhead and fewer plugins to maintain on your site.
31 |
32 | Pick and choose what you want.
33 |
34 | Why install a plugin that contains 30 modules if you’re already certain that you’re only going to need one of them? Beaver Brewer lets you install individual modules a la carte.
35 |
36 | Keep things up-to-date.
37 |
38 | Module developers can use our handy module.config file to enable easy, one-click updates for their module from the Wordpress admin area! All you need is a place to host your latest module zipball (GitHub and Bitbucket work great, but hosting it on your own site works too!).
39 |
40 | Brew your own.
41 |
42 | Whether you’re a developer who needs to crank out a module post haste, or just someone who wants to experiment a little, Beaver Brewer makes it quicker and easier to develop new modules from scratch.
43 |
44 |
45 |
46 | Downloads
47 |
48 | You can download the latest version of Beaver Brewer here. Keep in mind that Beaver Brewer is still considered to be in the Beta stage; be careful about using it on a production site (and keep regular backups just in case).
49 |
50 | Installation
51 |
52 |
53 | - Upload the beaver-brewer folder to the /wp-content/plugins/ directory.
54 | - Activate the Beaver Brewer plugin through the ‘Plugins’ menu in WordPress.
55 | - Install and activate modules under the ‘Beaver Brewer’ menu in the Wordpress admin.
56 |
57 |
58 | Feedback
59 |
60 | Please submit all bugs and/or feedback to ryan@beaverbrewer.com.
61 |
62 |
63 |
64 | Frequently Asked Questions
65 |
66 | Is this plugin compatible with the free/lite version of Beaver Builder?
67 |
68 | No, this plugin requires Beaver Builder Premium. But believe me, it’s worth the investment!
69 |
70 | Will this plugin work with any Beaver Builder module?
71 |
72 | Not necessarily. Some modules are dependent on a parent plugin in order to work. In order to ensure that your module is compatible with Beaver Brewer, please follow our compatibility requirements below.
73 |
74 | Can I still (separately) use Beaver Lodge or other plugins that contain Beaver Builder modules?
75 |
76 | Yes, absolutely– especially if those developers don’t offer individual module updates (e.g. making use of a module.config file).
77 |
78 | A module I’m using doesn’t contain a module.config file. Why?
79 |
80 | The module.config file is just something I’ve come up with to enable simple, one-click updates. Not all developers will take advantage of this feature (especially until Beaver Brewer becomes popular). This means that your module will need to be updated manually if/when the developer releases a new version, but it does not prevent the module from being used with Beaver Brewer.
81 |
82 | I don’t want to use the Beaver Brewer admin (or am having file permissions issues). How can I manually add modules?
83 |
84 | Simply drop your module folder into your wp-content/bb-modules directory. If the bb-modules directory does not exist (e.g., because of a permissions issue), you will have to create it.
85 |
86 |
87 |
88 | Troubleshooting
89 |
90 | General file/directory permissions issues
91 |
92 | File/folder permissions issues are the most likely problem you might experience with this plugin. As a general rule, you should use 644 permissions for files and 755 permissions for directories within your Wordpress installation (note that some files, such as your wp-config.php file, should be stricter than this). If the user that Wordpress uses on your server is not the owner of the files/folders in your Wordpress installation, it must be the group owner (and bumping permissions up to 664 for files, 775 for folders will be necessary). Do not use 777 permissions for anything that is accessible over the internet. For more, visit https://codex.wordpress.org/Changing_File_Permissions.
93 |
94 | A certain module is not showing up in the page builder
95 |
96 | Assuming that you’ve installed the module correctly, you may want to ensure that it meets the Beaver Brewer compatibility requirements (see below).
97 |
98 | A module is missing from the list on the Beaver Brewer admin page
99 |
100 | Check that your module folder’s file permissions allow it to be readable by the webserver. Also check that you’ve installed it correctly; there should be a folder (e.g., the name of the module) inside the wp-content/bb-modules directory, and inside that folder is where your individual module files should live. If there is no PHP file inside your module folder, Beaver Brewer will not recognize it as a valid module.
101 |
102 | Automatic updates are not available for one or more modules
103 |
104 | Modules that do not contain a module.config file will not be able to provide automatic/one-click updates. This is up to the module developer. While not having a module.config file does not prevent modules from being used with Beaver Brewer, any updates will need to be downloaded and applied manually.
105 |
106 | My plugin could not be activated because it triggered a fatal error.
107 |
108 | See your error log for more information.
109 |
110 | “Fatal error: Cannot redeclare class” issues
111 |
112 | This is when you try to activate two modules that contain identical class names (or a two copies of the same module). You must remove one of the modules, or else rename one of the classes causing the issue.
113 |
114 |
115 |
116 | Compatibility Requirements
117 |
118 | I plan on releasing complete online documentation for this plugin before it’s released into the wild, but the general rule for making your module compatible with Beaver Brewer is that you should avoid making it dependent on a parent plugin. If you follow the Beaver Builder custom module documentation (see this page), only skipping the very first part (about creating a plugin wrapper), you should be fine. The MY_MODULES_DIR and MY_MODULES_URL constants are defined by Beaver Brewer, and the init hook to load your module is already taken care of. You can see and download my plugin boilerplate if you’re having trouble getting started.
119 |
120 | To enable automatic updates for your module, you can utilize the module.config file. See http://beaverbrewer.com/module-config/ for more info.
121 |
122 | To Do
123 |
124 | There’s a lot more I’d like to do with this module in future versions. Here’s a few things:
125 |
126 |
127 | - Add a search / filter modules function on the Beaver Brewer admin page.
128 | - Detect any compatibility issues and warn the user on the admin page.
129 | - Create centralized Beaver Brewer module repository for community use (similar to the Wordpress plugin repository).
130 | - Improve README and provide full online documentation for making modules compatible with Beaver Brewer.
131 | - Improve automatic updates (use a true update server instead of relying on Bitbucket)
132 | - Create simple module boilerplate & generator app (which builds your module.config file, etc. for you).
133 | - Maybe make the Beaver Brewer admin page more closely resemble the Wordpress plugins admin page.
134 | - Invent a machine that warps spacetime just enough to achieve 30 hours’s worth of work in just one 8-hour day.
135 |
136 |
137 |
138 |
139 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Beaver Brewer #
2 | Contributors: rbenhase
3 | Tags: Beaver Builder, custom modules
4 | Requires at least: 4.3
5 | Tested up to: 4.5
6 |
7 | ***
8 |
9 | ## Homebrew for Beaver Builder ##
10 | Beaver Brewer extends the Beaver Builder plugin by giving admins the ability to easily install "homebrew" modules. It also enables developers to release their modules in an a la carte fashion (no plugin wrapper needed) and even offer automatic updates to their modules through the Wordpress dashboard. You can [download the plugin](http://beaverbrewer.com/downloads) and [download some modules](http://beaverbrewer.com/modules) right away to get started.
11 |
12 | Beaver Brewer is in active development and should be considered a Beta at this stage. For this reason, you should be cautious about using it on a Production site. When more features are added to the plugin, an automatic update will appear in your Wordpress plugin admin page.
13 |
14 | ***
15 |
16 | ## Overview ##
17 | Beaver Builder is a fantastic page builder plugin, and its support for custom modules gives it nearly limitless potential. But as the number of Beaver Builder modules increases, they can become a bit difficult for users (and developers) to manage. Beaver Brewer strives to change all that.
18 |
19 | #### Many modules. Many developers. One plugin. ####
20 | Instead of installing a different Wordpress plugin for every set of Beaver Builder modules you want to use, you can now install a single, lightweight plugin that handles them all. This means that a module developer doesn't necessarily need to build out an entire plugin wrapper for his/her project, and this translates into lower overhead and fewer plugins to maintain on your site.
21 |
22 | #### Pick and choose what you want. ####
23 | Why install a plugin that contains 30 modules if you're already certain that you're only going to need one of them? Beaver Brewer lets you install individual modules a la carte.
24 |
25 | #### Keep things up-to-date. ####
26 | Module developers can use our handy module.config file to enable easy, one-click updates for their module from the Wordpress admin area! All you need is a place to host your latest module zipball (GitHub and Bitbucket work great, but hosting it on your own site works too!).
27 |
28 | #### Brew your own. ####
29 | Whether you're a developer who needs to crank out a module post haste, or just someone who wants to experiment a little, Beaver Brewer makes it quicker and easier to develop new modules from scratch.
30 |
31 | ***
32 |
33 | ## Downloads ##
34 | You can [download the latest version of Beaver Brewer here](http://beaverbrewer.com/downloads). Keep in mind that Beaver Brewer is still considered to be in the Beta stage; be careful about using it on a production site (and keep regular backups just in case).
35 |
36 | ## Installation ##
37 | 1. Upload the beaver-brewer folder to the /wp-content/plugins/ directory.
38 | 2. Activate the Beaver Brewer plugin through the 'Plugins' menu in WordPress.
39 | 3. Install and activate modules under the 'Beaver Brewer' menu in the Wordpress admin.
40 |
41 | ## Feedback ##
42 | Please submit all bugs and/or feedback to ryan@beaverbrewer.com.
43 |
44 | ***
45 |
46 | ## Frequently Asked Questions ##
47 |
48 | #### Is this plugin compatible with the free/lite version of Beaver Builder? ####
49 | No, this plugin requires Beaver Builder Premium. But believe me, it's worth the investment!
50 |
51 | #### Will this plugin work with any Beaver Builder module? ####
52 | Not necessarily. Some modules are dependent on a parent plugin in order to work. In order to ensure that your module is compatible with Beaver Brewer, please follow our compatibility requirements below.
53 |
54 | #### Can I still (separately) use Beaver Lodge or other plugins that contain Beaver Builder modules? ####
55 | Yes, absolutely-- especially if those developers don't offer individual module updates (e.g. making use of a module.config file).
56 |
57 | #### A module I'm using doesn't contain a module.config file. Why? ####
58 | The module.config file is just something I've come up with to enable simple, one-click updates. Not all developers will take advantage of this feature (especially until Beaver Brewer becomes popular). This means that your module will need to be updated manually if/when the developer releases a new version, but it does not prevent the module from being used with Beaver Brewer.
59 |
60 | #### I don't want to use the Beaver Brewer admin (or am having file permissions issues). How can I manually add modules? ####
61 | Simply drop your module folder into your wp-content/bb-modules directory. If the bb-modules directory does not exist (e.g., because of a permissions issue), you will have to create it.
62 |
63 | ***
64 |
65 | ## Troubleshooting ##
66 |
67 | #### General file/directory permissions issues ####
68 | File/folder permissions issues are the most likely problem you might experience with this plugin. As a general rule, you should use 644 permissions for files and 755 permissions for directories within your Wordpress installation (note that some files, such as your wp-config.php file, should be stricter than this). If the user that Wordpress uses on your server is not the owner of the files/folders in your Wordpress installation, it must be the group owner (and bumping permissions up to 664 for files, 775 for folders will be necessary). Do not use 777 permissions for anything that is accessible over the internet. For more, visit [https://codex.wordpress.org/Changing_File_Permissions](https://codex.wordpress.org/Changing_File_Permissions).
69 |
70 | #### A certain module is not showing up in the page builder ####
71 | Assuming that you've installed the module correctly, you may want to ensure that it meets the Beaver Brewer compatibility requirements (see below).
72 |
73 | #### A module is missing from the list on the Beaver Brewer admin page ####
74 | Check that your module folder's file permissions allow it to be readable by the webserver. Also check that you've installed it correctly; there should be a folder (e.g., the name of the module) inside the wp-content/bb-modules directory, and inside that folder is where your individual module files should live. If there is no PHP file inside your module folder, Beaver Brewer will not recognize it as a valid module.
75 |
76 | #### Automatic updates are not available for one or more modules ####
77 | Modules that do not contain a module.config file will not be able to provide automatic/one-click updates. This is up to the module developer. While not having a module.config file does not prevent modules from being used with Beaver Brewer, any updates will need to be downloaded and applied manually.
78 |
79 | #### My plugin could not be activated because it triggered a fatal error. ####
80 | See your error log for more information.
81 |
82 | #### "Fatal error: Cannot redeclare class" issues ####
83 | This is when you try to activate two modules that contain identical class names (or a two copies of the same module). You must remove one of the modules, or else rename one of the classes causing the issue.
84 |
85 | ***
86 |
87 | ## Compatibility Requirements ##
88 | I plan on releasing complete online documentation for this plugin before it's released into the wild, but the general rule for making your module compatible with Beaver Brewer is that you should avoid making it dependent on a parent plugin. If you follow the Beaver Builder custom module documentation (see [this page](https://www.wpbeaverbuilder.com/custom-module-documentation/)), only skipping the very first part (about creating a plugin wrapper), you should be fine. The MY_MODULES_DIR and MY_MODULES_URL constants are defined by Beaver Brewer, and the init hook to load your module is already taken care of. You can see and download [my plugin boilerplate](http://beaverbrewer.com/downloads) if you're having trouble getting started.
89 |
90 | To enable automatic updates for your module, you can utilize the module.config file. See [http://beaverbrewer.com/module-config/](http://beaverbrewer.com/module-config/) for more info.
91 |
92 | ## To Do ##
93 | There's a lot more I'd like to do with this module in future versions. Here's a few things:
94 |
95 | - Add a search / filter modules function on the Beaver Brewer admin page.
96 | - Detect any compatibility issues and warn the user on the admin page.
97 | - Create centralized Beaver Brewer module repository for community use (similar to the Wordpress plugin repository).
98 | - Improve README and provide full online documentation for making modules compatible with Beaver Brewer.
99 | - Improve automatic updates (use a true update server instead of relying on Bitbucket)
100 | - Create simple module boilerplate & generator app (which builds your module.config file, etc. for you).
101 | - Maybe make the Beaver Brewer admin page more closely resemble the Wordpress plugins admin page.
102 | - Invent a machine that warps spacetime just enough to achieve 30 hours's worth of work in just one 8-hour day.
--------------------------------------------------------------------------------
/README.txt:
--------------------------------------------------------------------------------
1 | === Beaver Brewer ===
2 | Contributors: rbenhase
3 | Tags: Beaver Builder, custom modules
4 | Donate link: http://beaverbrewer.com/donate
5 | Requires at least: 4.0
6 | Tested up to: 4.5
7 |
8 | Extends the Beaver Builder plugin by giving admins the ability to easily install "homebrew" modules in an a la carte fashion.
9 |
10 | == Description ==
11 | Beaver Builder is a fantastic page builder plugin, and its support for custom modules gives it nearly limitless potential. But as the number of Beaver Builder modules increases, they can become a bit difficult for users (and developers) to manage. Beaver Brewer strives to change all that.
12 |
13 | = Many modules. Many developers. One plugin. =
14 | Instead of installing a different Wordpress plugin for every set of Beaver Builder modules you want to use, you can now install a single, lightweight plugin that handles them all. This means that a module developer doesn't necessarily need to build out an entire plugin wrapper for his/her project, and this translates into lower overhead and fewer plugins to maintain on your site.
15 |
16 | = Pick and choose what you want. =
17 | Why install a plugin that contains 30 modules if you're already certain that you're only going to need one of them? Beaver Brewer lets you install individual modules a la carte.
18 |
19 | = Keep things up-to-date. =
20 | Module developers can use our handy module.config file to enable easy, one-click updates for their module from the Wordpress admin area! All you need is a place to host your latest module zipball (GitHub and Bitbucket work great, but hosting it on your own site works too!).
21 |
22 | = Brew your own. =
23 | Whether you're a developer who needs to crank out a module post haste, or just someone who wants to experiment a little, Beaver Brewer makes it quicker and easier to develop new modules from scratch.
24 |
25 | == Installation ==
26 | 1. Upload the beaver-brewer folder to the /wp-content/plugins/ directory.
27 | 2. Activate the Beaver Brewer plugin through the 'Plugins' menu in WordPress.
28 | 3. Install and activate modules under the 'Beaver Brewer' menu in the Wordpress admin.
29 |
30 | == Frequently Asked Questions ==
31 | = Is this plugin compatible with the free/lite version of Beaver Builder? =
32 | No, this plugin requires Beaver Builder Premium. But believe me, it's worth the investment!
33 |
34 | = Will this plugin work with any Beaver Builder module? =
35 | Not necessarily. Some modules are dependent on a parent plugin in order to work. In order to ensure that your module is compatible with Beaver Brewer, please follow our compatibility requirements below.
36 |
37 | = Can I still (separately) use Beaver Lodge or other plugins that contain Beaver Builder modules? =
38 | Yes, absolutely-- especially if those developers don't offer individual module updates (e.g. making use of a module.config file).
39 |
40 | = A module I'm using doesn't contain a module.config file. Why? =
41 | The module.config file is just something I've come up with to enable simple, one-click updates. Not all developers will take advantage of this feature (especially until Beaver Brewer becomes popular). This means that your module will need to be updated manually if/when the developer releases a new version.
42 |
43 | = I don't want to use the Beaver Brewer admin (or am having file permissions issues). How can I manually add modules? =
44 | Simply drop your module folder into your wp-content/bb-modules directory. If the bb-modules directory does not exist (e.g., because of a permissions issue), you will have to create it.
45 |
46 | == Troubleshooting ==
47 |
48 | = General file/directory permissions issues =
49 | File/folder permissions issues are the most likely problem you might experience with this plugin. As a general rule, you should use 644 permissions for folders and 755 permissions for files within your Wordpress installation (note that some files, such as your wp-config.php file, should be stricter than this). If the user that Wordpress uses on your server is not the owner of the files/folders in your Wordpress installation, it must be the group owner (and bumping permissions up to 664 for folders, 775 for files will be necessary). Do not use 777 permissions for anything that is accessible over the internet. For more, visit https://codex.wordpress.org/Changing_File_Permissions.
50 |
51 | = A certain module is not showing up in the page builder =
52 | Assuming that you've installed the module correctly, you may want to ensure that it meets the Beaver Brewer compatibility requirements (see below).
53 |
54 | = A module is missing from the list on the Beaver Brewer admin page =
55 | Check that your module folder's file permissions allow it to be readable by the webserver. Also check that you've installed it correctly; there should be a folder (e.g., the name of the module) inside the wp-content/bb-modules directory, and inside that folder is where your individual module files should live. If there is no PHP file inside your module folder, Beaver Brewer will not recognize it as a valid module.
56 |
57 | = My plugin could not be activated because it triggered a fatal error. =
58 | See your error log for more information.
59 |
60 | = "Fatal error: Cannot redeclare class" issues =
61 | This is when you try to activate two modules that contain identical class names (or a two copies of the same module). You must remove one of the modules, or else rename one of the classes causing the issue.
62 |
63 | == Compatibility Requirements ==
64 | I plan on releasing complete online documentation for this plugin before it's released into the wild, but the general rule for making your module compatible with Beaver Brewer is that you should avoid making it dependent on a parent plugin. If you follow the Beaver Builder custom module documentation (see https://www.wpbeaverbuilder.com/custom-module-documentation/), only skipping the very first part (about creating a plugin wrapper), you should be fine. The MY_MODULES_DIR and MY_MODULES_URL constants are defined by Beaver Brewer, and the init hook to load your module is already taken care of. You can see and download my plugin boilerplate at http://beaverbrewer.com/downloads if you're having trouble getting started.
65 |
66 | To enable automatic updates for your module, you can utilize the module.config file. See http://beaverbrewer.com/module-config/ for more info.
67 |
68 | == To Do ==
69 | There's a lot more I'd like to do with this module in future versions. Here's a few things:
70 |
71 | - Add a search / filter modules function on the Beaver Brewer admin page.
72 | - Detect any compatibility issues and warn the user on the admin page.
73 | - Create centralized Beaver Brewer module repository for community use (similar to the Wordpress plugin repository).
74 | - Improve README and provide full online documentation for making modules compatible with Beaver Brewer.
75 | - Improve automatic updates (use a true update server instead of relying on Bitbucket)
76 | - Create simple module boilerplate & generator app (which builds your module.config file, etc. for you).
77 | - Maybe make the Beaver Brewer admin page more closely resemble the Wordpress plugins admin page.
78 | - Invent a machine that warps spacetime just enough to achieve 30 hours's worth of work in just one 8-hour day.
--------------------------------------------------------------------------------
/admin/class-beaver-brewer-admin.php:
--------------------------------------------------------------------------------
1 |
22 | */
23 | class Beaver_Brewer_Admin {
24 |
25 | /**
26 | * The ID of this plugin.
27 | *
28 | * @since 0.1.0
29 | * @access private
30 | * @var string $plugin_name The ID of this plugin.
31 | */
32 | private $plugin_name;
33 |
34 | /**
35 | * The version of this plugin.
36 | *
37 | * @since 0.1.0
38 | * @access private
39 | * @var string $version The current version of this plugin.
40 | */
41 | private $version;
42 |
43 | /**
44 | * All modules and their relevant data.
45 | *
46 | * @since 0.1.0
47 | * @access private
48 | * @var array $modules All recognized modules.
49 | */
50 | private $modules;
51 |
52 |
53 | /**
54 | * Initialize the class and set its properties.
55 | *
56 | * @since 0.1.0
57 | * @param string $plugin_name The name of this plugin.
58 | * @param string $version The version of this plugin.
59 | * @param Beaver_Brewer $brewer An instance of the main Beaver Brewer class.
60 | */
61 | public function __construct( $plugin_name, $version, $modules ) {
62 |
63 | $this->plugin_name = $plugin_name;
64 | $this->version = $version;
65 | $this->modules = $modules;
66 | }
67 |
68 |
69 | /**
70 | * Add the Beaver Brewer menu item.
71 | *
72 | * @since 0.1.0
73 | */
74 | public function add_menu_page() {
75 |
76 | // Count updates (retrieve cached value in DB if available)
77 | $update_count = get_transient( "beaver-brewer-updates" );
78 | if ( $update_count === false )
79 | $update_count = $this->count_updates();
80 |
81 | $update_title = $update_count . __( "Updates" );
82 |
83 | // If there are module updates waiting
84 | if ( $update_count > 0 ) {
85 | $menu_label = sprintf(
86 | __( "Beaver Brewer %s" ),
87 | "" . number_format_i18n($update_count) . ""
88 | );
89 |
90 | } else {
91 | $menu_label = __( "Beaver Brewer" );
92 | }
93 |
94 | add_menu_page(
95 | __( 'Beaver Brewer', $this->plugin_name ),
96 | $menu_label,
97 | 'manage_options',
98 | 'beaver-brewer',
99 | array( $this, 'render_admin' ),
100 | 'data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz48c3ZnIHZlcnNpb249IjEuMSIgaWQ9InN2ZzIiIGlua3NjYXBlOnZlcnNpb249IjAuNDguMiByOTgxOSIgc29kaXBvZGk6ZG9jbmFtZT0iYm90dGxlX2xvbmduZWNrLnN2ZyIgeG1sbnM6Y2M9Imh0dHA6Ly9jcmVhdGl2ZWNvbW1vbnMub3JnL25zIyIgeG1sbnM6ZGM9Imh0dHA6Ly9wdXJsLm9yZy9kYy9lbGVtZW50cy8xLjEvIiB4bWxuczppbmtzY2FwZT0iaHR0cDovL3d3dy5pbmtzY2FwZS5vcmcvbmFtZXNwYWNlcy9pbmtzY2FwZSIgeG1sbnM6bnMxPSJodHRwOi8vc296aS5iYWllcm91Z2UuZnIiIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyIgeG1sbnM6c29kaXBvZGk9Imh0dHA6Ly9zb2RpcG9kaS5zb3VyY2Vmb3JnZS5uZXQvRFREL3NvZGlwb2RpLTAuZHRkIiB4bWxuczpzdmc9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4PSIwcHgiIHk9IjBweCIgdmlld0JveD0iMCAwIDc0NC4xIDEwNTIuNCIgc3R5bGU9ImVuYWJsZS1iYWNrZ3JvdW5kOm5ldyAwIDAgNzQ0LjEgMTA1Mi40OyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI+PHNvZGlwb2RpOm5hbWVkdmlldyAgYm9yZGVyY29sb3I9IiM2NjY2NjYiIGJvcmRlcm9wYWNpdHk9IjEuMCIgaWQ9ImJhc2UiIGlua3NjYXBlOmN1cnJlbnQtbGF5ZXI9ImxheWVyMSIgaW5rc2NhcGU6Y3g9IjE0Ni4wMTMyMyIgaW5rc2NhcGU6Y3k9IjU1NC43NTY4OCIgaW5rc2NhcGU6ZG9jdW1lbnQtdW5pdHM9InB4IiBpbmtzY2FwZTpwYWdlb3BhY2l0eT0iMC4wIiBpbmtzY2FwZTpwYWdlc2hhZG93PSIyIiBpbmtzY2FwZTp3aW5kb3ctaGVpZ2h0PSIxMDI2IiBpbmtzY2FwZTp3aW5kb3ctbWF4aW1pemVkPSIxIiBpbmtzY2FwZTp3aW5kb3ctd2lkdGg9IjE2ODAiIGlua3NjYXBlOndpbmRvdy14PSIwIiBpbmtzY2FwZTp3aW5kb3cteT0iMjQiIGlua3NjYXBlOnpvb209IjAuNDk0OTc0NzUiIHBhZ2Vjb2xvcj0iI2ZmZmZmZiIgc2hvd2dyaWQ9ImZhbHNlIj48L3NvZGlwb2RpOm5hbWVkdmlldz48Zz48cGF0aCBkPSJNMjU3LDU1My43bC05LjQtOC4ybC0xNy4xLDE5LjZsOS40LDguMmM5LjUsOC4zLDE3LjEsOS4xLDIyLjgsMi42QzI2OC40LDU2OS40LDI2Ni41LDU2MiwyNTcsNTUzLjd6Ii8+PHBhdGggZD0iTTM2MS41LDYxOC44YzMuNCwwLjgsNi43LTAuNiw5LjktNC4zYzMuMi0zLjcsNC4xLTcuMiwyLjctMTAuNWMtMS40LTMuMy00LjYtNy4yLTkuOC0xMS43bC00LjktNC4ybC0xNiwxOC40bDUsNC4zQzM1My44LDYxNS4zLDM1OC4xLDYxOCwzNjEuNSw2MTguOHoiLz48cGF0aCBkPSJNMzQxLjgsNjI3LjRsLTkuNC04LjJsLTE3LjEsMTkuNmw5LjQsOC4yYzkuNSw4LjMsMTcuMSw5LjEsMjIuOCwyLjZDMzUzLjIsNjQzLjEsMzUxLjMsNjM1LjcsMzQxLjgsNjI3LjR6Ii8+PHBhdGggZD0iTTQ1OC41LDU3MS4xYzMxLjktMzkuMSwxNy05MC40LDM2LjctMTE1LjRMNjIxLDI4Ny41YzE5LjEsNS45LDI2LjUtMjQsMzAuMS0zMi45YzE4LjgtNSwxMC44LTEzLjksMTAuNS0xNy41Yy0yMi44LTIzLjgtMzQuNy0zMy41LTYzLjgtNTQuOGMwLDAtMTcuNy0wLjYtMTIuNywxNC40Yy0xLjMsNi4yLTQwLjgsMTEuMi0yOS4zLDM0LjVsLTE1MSwxNDljLTI3LDIzLjktNjgsMTQtMTAxLjEsNDYuNkwzMC44LDc0NS4xYzAsMC0xMi45LDE0LjgtMTIuOSwyMi43bDAsMGMxLjUsMzQsMTIzLjcsMTM1LjUsMTQzLjcsMTI2LjhjMTQuNiwwLjcsMzIuOS0yNC4zLDMyLjktMjQuM0w0NTguNSw1NzEuMXogTTI2NC42LDYwN2MtNy45LDAtMTYtMy41LTI0LjEtMTAuNUwxOTYuMiw1NThsNjYuNi03Ni42bDM3LDMyLjJjNC44LDQuMiw4LjYsOC4zLDExLjMsMTIuM2MyLjgsNCw0LjUsNy44LDUuMywxMS4zYzAuOCwzLjUsMC44LDYuOC0wLjEsOS45Yy0wLjgsMy4xLTIuNCw1LjktNC42LDguNWMtMi40LDIuOC01LjIsNC45LTguNCw2LjNjLTMuMiwxLjQtNi4yLDIuMi05LjIsMi4zYy0zLDAuMS01LjYtMC4zLTcuOC0xLjFjMy40LDYuNiw1LjIsMTIuNyw1LjIsMTguMmMwLDUuNS0yLjIsMTAuOC02LjUsMTUuOEMyNzkuNCw2MDMuNywyNzIuNSw2MDcsMjY0LjYsNjA3eiBNMzQ5LjQsNjgwLjdjLTcuOSwwLTE2LTMuNS0yNC4xLTEwLjVMMjgxLDYzMS43bDY2LjYtNzYuNmwzNywzMi4yYzQuOCw0LjIsOC42LDguMywxMS4zLDEyLjNjMi44LDQsNC41LDcuOCw1LjMsMTEuM2MwLjgsMy41LDAuOCw2LjgtMC4xLDkuOWMtMC44LDMuMS0yLjQsNS45LTQuNiw4LjVjLTIuNCwyLjgtNS4yLDQuOS04LjQsNi4zYy0zLjIsMS40LTYuMiwyLjItOS4yLDIuM2MtMywwLjEtNS42LTAuMy03LjgtMS4xYzMuNCw2LjYsNS4yLDEyLjcsNS4yLDE4LjJjMCw1LjUtMi4yLDEwLjgtNi41LDE1LjhDMzY0LjEsNjc3LjQsMzU3LjMsNjgwLjcsMzQ5LjQsNjgwLjd6Ii8+PHBhdGggZD0iTTI3Ni44LDU0NS4xYzMuNCwwLjgsNi43LTAuNiw5LjktNC4zYzMuMi0zLjcsNC4xLTcuMiwyLjctMTAuNWMtMS40LTMuMy00LjYtNy4yLTkuOC0xMS43bC00LjktNC4ybC0xNiwxOC40bDUsNC4zQzI2OSw1NDEuNiwyNzMuNCw1NDQuMywyNzYuOCw1NDUuMXoiLz48L2c+PC9zdmc+',
101 | 60
102 | );
103 |
104 | }
105 |
106 | /**
107 | * Render the Beaver Brewer admin page.
108 | *
109 | * @since 0.1.0
110 | */
111 | public function render_admin() {
112 |
113 | // See if we are supposed to activate any modules and update their status accordinly.
114 | if ( !empty( $_GET['activate'] ) && wp_verify_nonce( $_GET['activate_module_nonce'], 'activate_module' ) ) {
115 | $result = $this->activate_module( $_GET['activate'] );
116 | if ( $result ) {
117 | foreach ( $this->modules as $k => $module ) {
118 | if ( $module['name'] == $_GET['activate'] ) {
119 | $this->modules[$k]['active'] = true;
120 | $this->print_message(
121 | __( "Module Activated", $this->plugin_name ),
122 | sprintf( __( "Successfully activated the %s module.", $this->plugin_name ), ( !empty( $this->modules[$k]['nicename'] ) ? $this->modules[$k]['nicename'] : $this->modules[$k]['name'] ) )
123 | );
124 | }
125 | }
126 | }
127 | }
128 |
129 | $update_count = 0;
130 |
131 | include_once( 'partials/beaver-brewer-admin-display.php' );
132 |
133 | // If updates are available, update the cached value
134 | if ( $update_count > 0 )
135 | set_transient( "beaver-brewer-updates", $update_count, 12 * HOUR_IN_SECONDS );
136 | }
137 |
138 |
139 | /**
140 | * Render the admin page tab navigation.
141 | *
142 | * @since 0.3.0
143 | * @return Int $current The current active tab
144 | */
145 | public function get_admin_page_tabs() {
146 | $tabs = array(
147 | "my-modules" => __( "My Modules", $this->plugin_name ),
148 | "find-more" => __( "Find More Modules", $this->plugin_name )
149 | );
150 |
151 | $current = ( isset( $_REQUEST['tab'] ) ? $_REQUEST['tab'] : 'my-modules' );
152 |
153 | echo '';
154 | foreach( $tabs as $tab => $name ){
155 | $class = ( $tab == $current ) ? ' nav-tab-active' : '';
156 | echo "$name";
157 | }
158 | echo '
';
159 | return $current;
160 | }
161 |
162 |
163 | /**
164 | * Render the module results on the "Find Modules" page.
165 | *
166 | * @since 0.3.0
167 | */
168 | public function prepare_module_results() {
169 |
170 | $result_page = ( isset( $_REQUEST['result_page'] ) ? $_REQUEST['result_page'] : 1 );
171 |
172 | echo '';
173 | if ( isset( $_REQUEST['search'] ) ) {
174 | $response = wp_remote_get( 'http://beaverbrewer.com/wp-json/brewer/v2/modules-search/' . urlencode( $_REQUEST['search'] ) . '/' . $result_page );
175 | _e( "Search Results: ", $this->plugin_name );
176 | echo $_REQUEST['search'];
177 | } else if ( isset( $_REQUEST['orderby'] ) && $_REQUEST['orderby'] == 'name' ) {
178 | $response = wp_remote_get( 'http://beaverbrewer.com/wp-json/brewer/v2/modules-alphabetical/' . ( !empty( $_REQUEST['filter'] ) ? urlencode( $_REQUEST['filter'] ) : 'none' ) . '/' . $result_page );
179 | _e( "Modules - Alphabetical", $this->plugin_name );
180 | } else if ( isset( $_REQUEST['orderby'] ) && $_REQUEST['orderby'] == 'date_asc' ) {
181 | $response = wp_remote_get( 'http://beaverbrewer.com/wp-json/brewer/v2/modules-oldest/' . ( !empty( $_REQUEST['filter'] ) ? urlencode( $_REQUEST['filter'] ) : 'none' ) . '/' . $result_page );
182 | _e( "Oldest Added Modules", $this->plugin_name );
183 | } else {
184 | $response = wp_remote_get( 'http://beaverbrewer.com/wp-json/brewer/v2/modules-latest/' . ( !empty( $_REQUEST['filter'] ) ? urlencode( $_REQUEST['filter'] ) : 'none' ) . '/' . $result_page );
185 | _e( "Recently Added Modules", $this->plugin_name );
186 | }
187 | echo '
';
188 |
189 | $this->render_module_results( $response );
190 |
191 | }
192 |
193 | /**
194 | * Render the module results on the "Find Modules" page.
195 | *
196 | * @since 0.3.0
197 | * @param Object $response The response from the BB Module API.
198 | */
199 | public function render_module_results( $response ) {
200 | ?>
201 |
202 |
275 |
276 |
319 |
320 |
321 |
plugin_name ); ?>
322 |
323 |
324 |
";
845 | echo '
';
846 | echo "$title: $message";
847 | echo '
';
848 | echo '
18 |
plugin_name ); ?>
19 |
20 | check_directory(); ?>
21 |
22 |
23 |
24 | get_admin_page_tabs(); ?>
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
plugin_name ); ?>
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 | plugin_name ); ?>
52 | plugin_name ); ?>
53 |
54 |
18 |
19 |
plugin_name ); ?>
20 |
21 |
22 |
55 |
56 |
57 | prepare_module_results(); ?>
58 |
59 |
60 |
14 |
15 |
plugin_name ); ?>
16 |
41 |
14 |
15 |
plugin_name ); ?>
16 |
plugin_name ); ?>
17 |
18 |
19 |
20 | modules ) ): ?>
21 |
22 | modules as $module ): ?>
23 |
24 | check_updates( $module ); ?>
25 |
26 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 | Version .
38 |
39 |
40 |
41 | ' . $module['description'] . '' : '' ); ?>
42 |
43 |
44 |
45 | → More Information' : '' ); ?>
46 |
47 |
48 | get_latest( $module['updates'] ) : false ); ?>
49 |
74 |
75 |
91 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
plugin_name ); ?>
101 |
102 |
103 | plugin_name ); ?>
104 | plugin_name ); ?>
105 |
106 |
107 |
108 |
109 |
110 |
';
433 | echo '
';
434 |
435 | echo '';
436 | _e( "Beaver Brewer Deactivated: ");
437 | echo '';
438 |
439 | _e( "The Beaver Brewer plugin requires Beaver Builder Premium in order to work. Since Beaver Builder was not found, Beaver Brewer has been deactivated.", $this->plugin_name );
440 |
441 | echo '
';
442 | echo '
',
27 | esc_attr($this->updateChecker->slug),
28 | esc_attr(wp_create_nonce('puc-ajax'))
29 | );
30 |
31 | $this->displayConfiguration();
32 | $this->displayStatus();
33 | $this->displayCurrentUpdate();
34 |
35 | echo '
';
36 | }
37 |
38 | private function displayConfiguration() {
39 | echo 'Configuration
';
40 | echo '';
41 | $this->row('Plugin file', htmlentities($this->updateChecker->pluginFile));
42 | $this->row('Slug', htmlentities($this->updateChecker->slug));
43 | $this->row('DB option', htmlentities($this->updateChecker->optionName));
44 |
45 | $requestInfoButton = '';
46 | if ( function_exists('get_submit_button') ) {
47 | $requestInfoButton = get_submit_button('Request Info', 'secondary', 'puc-request-info-button', false, array('id' => 'puc-request-info-button-' . $this->updateChecker->slug));
48 | }
49 | $this->row('Metadata URL', htmlentities($this->updateChecker->metadataUrl) . ' ' . $requestInfoButton . $this->responseBox);
50 |
51 | $scheduler = $this->updateChecker->scheduler;
52 | if ( $scheduler->checkPeriod > 0 ) {
53 | $this->row('Automatic checks', 'Every ' . $scheduler->checkPeriod . ' hours');
54 | } else {
55 | $this->row('Automatic checks', 'Disabled');
56 | }
57 |
58 | if ( isset($scheduler->throttleRedundantChecks) ) {
59 | if ( $scheduler->throttleRedundantChecks && ($scheduler->checkPeriod > 0) ) {
60 | $this->row(
61 | 'Throttling',
62 | sprintf(
63 | 'Enabled. If an update is already available, check for updates every %1$d hours instead of every %2$d hours.',
64 | $scheduler->throttledCheckPeriod,
65 | $scheduler->checkPeriod
66 | )
67 | );
68 | } else {
69 | $this->row('Throttling', 'Disabled');
70 | }
71 | }
72 | echo '
';
73 | }
74 |
75 | private function displayStatus() {
76 | echo 'Status
';
77 | echo '';
78 | $state = $this->updateChecker->getUpdateState();
79 | $checkNowButton = '';
80 | if ( function_exists('get_submit_button') ) {
81 | $checkNowButton = get_submit_button('Check Now', 'secondary', 'puc-check-now-button', false, array('id' => 'puc-check-now-button-' . $this->updateChecker->slug));
82 | }
83 |
84 | if ( isset($state, $state->lastCheck) ) {
85 | $this->row('Last check', $this->formatTimeWithDelta($state->lastCheck) . ' ' . $checkNowButton . $this->responseBox);
86 | } else {
87 | $this->row('Last check', 'Never');
88 | }
89 |
90 | $nextCheck = wp_next_scheduled($this->updateChecker->scheduler->getCronHookName());
91 | $this->row('Next automatic check', $this->formatTimeWithDelta($nextCheck));
92 |
93 | if ( isset($state, $state->checkedVersion) ) {
94 | $this->row('Checked version', htmlentities($state->checkedVersion));
95 | $this->row('Cached update', $state->update);
96 | }
97 | $this->row('Update checker class', htmlentities(get_class($this->updateChecker)));
98 | echo '
';
99 | }
100 |
101 | private function displayCurrentUpdate() {
102 | $update = $this->updateChecker->getUpdate();
103 | if ( $update !== null ) {
104 | echo 'An Update Is Available
';
105 | echo '';
106 | $fields = array('version', 'download_url', 'slug', 'homepage', 'upgrade_notice');
107 | foreach($fields as $field) {
108 | $this->row(ucwords(str_replace('_', ' ', $field)), htmlentities($update->$field));
109 | }
110 | echo '
';
111 | } else {
112 | echo 'No updates currently available
';
113 | }
114 | }
115 |
116 | private function formatTimeWithDelta($unixTime) {
117 | if ( empty($unixTime) ) {
118 | return 'Never';
119 | }
120 |
121 | $delta = time() - $unixTime;
122 | $result = human_time_diff(time(), $unixTime);
123 | if ( $delta < 0 ) {
124 | $result = 'after ' . $result;
125 | } else {
126 | $result = $result . ' ago';
127 | }
128 | $result .= ' (' . $this->formatTimestamp($unixTime) . ')';
129 | return $result;
130 | }
131 |
132 | private function formatTimestamp($unixTime) {
133 | return gmdate('Y-m-d H:i:s', $unixTime + (get_option('gmt_offset') * 3600));
134 | }
135 |
136 | private function row($name, $value) {
137 | if ( is_object($value) || is_array($value) ) {
138 | $value = '' . htmlentities(print_r($value, true)) . '
';
139 | } else if ($value === null) {
140 | $value = 'null';
141 | }
142 | printf('| %1$s | %2$s |
|---|
', $name, $value);
143 | }
144 | }
145 |
146 | }
147 |
--------------------------------------------------------------------------------
/includes/plugin-update-checker/debug-bar-plugin.php:
--------------------------------------------------------------------------------
1 | updateChecker = $updateChecker;
10 |
11 | add_filter('debug_bar_panels', array($this, 'addDebugBarPanel'));
12 | add_action('debug_bar_enqueue_scripts', array($this, 'enqueuePanelDependencies'));
13 |
14 | add_action('wp_ajax_puc_debug_check_now', array($this, 'ajaxCheckNow'));
15 | add_action('wp_ajax_puc_debug_request_info', array($this, 'ajaxRequestInfo'));
16 | }
17 |
18 | /**
19 | * Register the PUC Debug Bar panel.
20 | *
21 | * @param array $panels
22 | * @return array
23 | */
24 | public function addDebugBarPanel($panels) {
25 | require_once dirname(__FILE__) . '/debug-bar-panel.php';
26 | if ( current_user_can('update_plugins') && class_exists('PluginUpdateCheckerPanel_3_1', false) ) {
27 | $panels[] = new PluginUpdateCheckerPanel_3_1($this->updateChecker);
28 | }
29 | return $panels;
30 | }
31 |
32 | /**
33 | * Enqueue our Debug Bar scripts and styles.
34 | */
35 | public function enqueuePanelDependencies() {
36 | wp_enqueue_style(
37 | 'puc-debug-bar-style',
38 | plugins_url( "/css/puc-debug-bar.css", __FILE__ ),
39 | array('debug-bar'),
40 | '20130927'
41 | );
42 |
43 | wp_enqueue_script(
44 | 'puc-debug-bar-js',
45 | plugins_url( "/js/debug-bar.js", __FILE__ ),
46 | array('jquery'),
47 | '20121026'
48 | );
49 | }
50 |
51 | /**
52 | * Run an update check and output the result. Useful for making sure that
53 | * the update checking process works as expected.
54 | */
55 | public function ajaxCheckNow() {
56 | if ( $_POST['slug'] !== $this->updateChecker->slug ) {
57 | return;
58 | }
59 | $this->preAjaxReqest();
60 | $update = $this->updateChecker->checkForUpdates();
61 | if ( $update !== null ) {
62 | echo "An update is available:";
63 | echo '', htmlentities(print_r($update, true)), '
';
64 | } else {
65 | echo 'No updates found.';
66 | }
67 | exit;
68 | }
69 |
70 | /**
71 | * Request plugin info and output it.
72 | */
73 | public function ajaxRequestInfo() {
74 | if ( $_POST['slug'] !== $this->updateChecker->slug ) {
75 | return;
76 | }
77 | $this->preAjaxReqest();
78 | $info = $this->updateChecker->requestInfo();
79 | if ( $info !== null ) {
80 | echo 'Successfully retrieved plugin info from the metadata URL:';
81 | echo '', htmlentities(print_r($info, true)), '
';
82 | } else {
83 | echo 'Failed to retrieve plugin info from the metadata URL.';
84 | }
85 | exit;
86 | }
87 |
88 | /**
89 | * Check access permissions and enable error display (for debugging).
90 | */
91 | private function preAjaxReqest() {
92 | if ( !current_user_can('update_plugins') ) {
93 | die('Access denied');
94 | }
95 | check_ajax_referer('puc-ajax');
96 |
97 | error_reporting(E_ALL);
98 | @ini_set('display_errors','On');
99 | }
100 | }
101 |
102 | }
--------------------------------------------------------------------------------
/includes/plugin-update-checker/github-checker.php:
--------------------------------------------------------------------------------
1 | repositoryUrl = $repositoryUrl;
40 | $this->branch = empty($branch) ? 'master' : $branch;
41 |
42 | $path = @parse_url($repositoryUrl, PHP_URL_PATH);
43 | if ( preg_match('@^/?(?P[^/]+?)/(?P[^/#?&]+?)/?$@', $path, $matches) ) {
44 | $this->userName = $matches['username'];
45 | $this->repositoryName = $matches['repository'];
46 | } else {
47 | throw new InvalidArgumentException('Invalid GitHub repository URL: "' . $repositoryUrl . '"');
48 | }
49 |
50 | parent::__construct($repositoryUrl, $pluginFile, '', $checkPeriod, $optionName, $muPluginFile);
51 | }
52 |
53 | /**
54 | * Retrieve details about the latest plugin version from GitHub.
55 | *
56 | * @param array $unusedQueryArgs Unused.
57 | * @return PluginInfo_3_1
58 | */
59 | public function requestInfo($unusedQueryArgs = array()) {
60 | $info = new PluginInfo_3_1();
61 | $info->filename = $this->pluginFile;
62 | $info->slug = $this->slug;
63 |
64 | $this->setInfoFromHeader($this->getPluginHeader(), $info);
65 |
66 | //Figure out which reference (tag or branch) we'll use to get the latest version of the plugin.
67 | $ref = $this->branch;
68 | if ( $this->branch === 'master' ) {
69 | //Use the latest release.
70 | $release = $this->getLatestRelease();
71 | if ( $release !== null ) {
72 | $ref = $release->tag_name;
73 | $info->version = ltrim($release->tag_name, 'v'); //Remove the "v" prefix from "v1.2.3".
74 | $info->last_updated = $release->created_at;
75 | $info->download_url = $release->zipball_url;
76 |
77 | if ( !empty($release->body) ) {
78 | $info->sections['changelog'] = $this->parseMarkdown($release->body);
79 | }
80 | if ( isset($release->assets[0]) ) {
81 | $info->downloaded = $release->assets[0]->download_count;
82 | }
83 | } else {
84 | //Failing that, use the tag with the highest version number.
85 | $tag = $this->getLatestTag();
86 | if ( $tag !== null ) {
87 | $ref = $tag->name;
88 | $info->version = $tag->name;
89 | $info->download_url = $tag->zipball_url;
90 | }
91 | }
92 | }
93 |
94 | if ( empty($info->download_url) ) {
95 | $info->download_url = $this->buildArchiveDownloadUrl($ref);
96 | } else if ( !empty($this->accessToken) ) {
97 | $info->download_url = add_query_arg('access_token', $this->accessToken, $info->download_url);
98 | }
99 |
100 | //Get headers from the main plugin file in this branch/tag. Its "Version" header and other metadata
101 | //are what the WordPress install will actually see after upgrading, so they take precedence over releases/tags.
102 | $mainPluginFile = basename($this->pluginFile);
103 | $remotePlugin = $this->getRemoteFile($mainPluginFile, $ref);
104 | if ( !empty($remotePlugin) ) {
105 | $remoteHeader = $this->getFileHeader($remotePlugin);
106 | $this->setInfoFromHeader($remoteHeader, $info);
107 | }
108 |
109 | //Try parsing readme.txt. If it's formatted according to WordPress.org standards, it will contain
110 | //a lot of useful information like the required/tested WP version, changelog, and so on.
111 | if ( $this->readmeTxtExistsLocally() ) {
112 | $this->setInfoFromRemoteReadme($ref, $info);
113 | }
114 |
115 | //The changelog might be in a separate file.
116 | if ( empty($info->sections['changelog']) ) {
117 | $info->sections['changelog'] = $this->getRemoteChangelog($ref);
118 | if ( empty($info->sections['changelog']) ) {
119 | $info->sections['changelog'] = __('There is no changelog available.', 'plugin-update-checker');
120 | }
121 | }
122 |
123 | if ( empty($info->last_updated) ) {
124 | //Fetch the latest commit that changed the main plugin file and use it as the "last_updated" date.
125 | //It's reasonable to assume that every update will change the version number in that file.
126 | $latestCommit = $this->getLatestCommit($mainPluginFile, $ref);
127 | if ( $latestCommit !== null ) {
128 | $info->last_updated = $latestCommit->commit->author->date;
129 | }
130 | }
131 |
132 | $info = apply_filters('puc_request_info_result-' . $this->slug, $info, null);
133 | return $info;
134 | }
135 |
136 | /**
137 | * Get the latest release from GitHub.
138 | *
139 | * @return StdClass|null
140 | */
141 | protected function getLatestRelease() {
142 | $releases = $this->api('/repos/:user/:repo/releases');
143 | if ( is_wp_error($releases) || !is_array($releases) || !isset($releases[0]) ) {
144 | return null;
145 | }
146 |
147 | $latestRelease = $releases[0];
148 | return $latestRelease;
149 | }
150 |
151 | /**
152 | * Get the tag that looks like the highest version number.
153 | *
154 | * @return StdClass|null
155 | */
156 | protected function getLatestTag() {
157 | $tags = $this->api('/repos/:user/:repo/tags');
158 |
159 | if ( is_wp_error($tags) || empty($tags) || !is_array($tags) ) {
160 | return null;
161 | }
162 |
163 | usort($tags, array($this, 'compareTagNames')); //Sort from highest to lowest.
164 | return $tags[0];
165 | }
166 |
167 | /**
168 | * Compare two GitHub tags as if they were version number.
169 | *
170 | * @param string $tag1
171 | * @param string $tag2
172 | * @return int
173 | */
174 | protected function compareTagNames($tag1, $tag2) {
175 | if ( !isset($tag1->name) ) {
176 | return 1;
177 | }
178 | if ( !isset($tag2->name) ) {
179 | return -1;
180 | }
181 | return -version_compare($tag1->name, $tag2->name);
182 | }
183 |
184 | /**
185 | * Get the latest commit that changed the specified file.
186 | *
187 | * @param string $filename
188 | * @param string $ref Reference name (e.g. branch or tag).
189 | * @return StdClass|null
190 | */
191 | protected function getLatestCommit($filename, $ref = 'master') {
192 | $commits = $this->api(
193 | '/repos/:user/:repo/commits',
194 | array(
195 | 'path' => $filename,
196 | 'sha' => $ref,
197 | )
198 | );
199 | if ( !is_wp_error($commits) && is_array($commits) && isset($commits[0]) ) {
200 | return $commits[0];
201 | }
202 | return null;
203 | }
204 |
205 | protected function getRemoteChangelog($ref = '') {
206 | $filename = $this->getChangelogFilename();
207 | if ( empty($filename) ) {
208 | return null;
209 | }
210 |
211 | $changelog = $this->getRemoteFile($filename, $ref);
212 | if ( $changelog === null ) {
213 | return null;
214 | }
215 | return $this->parseMarkdown($changelog);
216 | }
217 |
218 | protected function getChangelogFilename() {
219 | $pluginDirectory = dirname($this->pluginAbsolutePath);
220 | if ( empty($this->pluginAbsolutePath) || !is_dir($pluginDirectory) || ($pluginDirectory === '.') ) {
221 | return null;
222 | }
223 |
224 | $possibleNames = array('CHANGES.md', 'CHANGELOG.md', 'changes.md', 'changelog.md');
225 | $files = scandir($pluginDirectory);
226 | $foundNames = array_intersect($possibleNames, $files);
227 |
228 | if ( !empty($foundNames) ) {
229 | return reset($foundNames);
230 | }
231 | return null;
232 | }
233 |
234 | /**
235 | * Convert Markdown to HTML.
236 | *
237 | * @param string $markdown
238 | * @return string
239 | */
240 | protected function parseMarkdown($markdown) {
241 | if ( !class_exists('Parsedown', false) ) {
242 | require_once(dirname(__FILE__) . '/vendor/Parsedown' . (version_compare(PHP_VERSION, '5.3.0', '>=') ? '' : 'Legacy') . '.php');
243 | }
244 |
245 | $instance = Parsedown::instance();
246 | return $instance->text($markdown);
247 | }
248 |
249 | /**
250 | * Perform a GitHub API request.
251 | *
252 | * @param string $url
253 | * @param array $queryParams
254 | * @return mixed|WP_Error
255 | */
256 | protected function api($url, $queryParams = array()) {
257 | $variables = array(
258 | 'user' => $this->userName,
259 | 'repo' => $this->repositoryName,
260 | );
261 | foreach ($variables as $name => $value) {
262 | $url = str_replace('/:' . $name, '/' . urlencode($value), $url);
263 | }
264 | $url = 'https://api.github.com' . $url;
265 |
266 | if ( !empty($this->accessToken) ) {
267 | $queryParams['access_token'] = $this->accessToken;
268 | }
269 | if ( !empty($queryParams) ) {
270 | $url = add_query_arg($queryParams, $url);
271 | }
272 |
273 | $response = wp_remote_get($url, array('timeout' => 10));
274 | if ( is_wp_error($response) ) {
275 | return $response;
276 | }
277 |
278 | $code = wp_remote_retrieve_response_code($response);
279 | $body = wp_remote_retrieve_body($response);
280 | if ( $code === 200 ) {
281 | $document = json_decode($body);
282 | return $document;
283 | }
284 |
285 | return new WP_Error(
286 | 'puc-github-http-error',
287 | 'GitHub API error. HTTP status: ' . $code
288 | );
289 | }
290 |
291 | /**
292 | * Set the access token that will be used to make authenticated GitHub API requests.
293 | *
294 | * @param string $accessToken
295 | */
296 | public function setAccessToken($accessToken) {
297 | $this->accessToken = $accessToken;
298 | }
299 |
300 | /**
301 | * Get the contents of a file from a specific branch or tag.
302 | *
303 | * @param string $path File name.
304 | * @param string $ref
305 | * @return null|string Either the contents of the file, or null if the file doesn't exist or there's an error.
306 | */
307 | protected function getRemoteFile($path, $ref = 'master') {
308 | $apiUrl = '/repos/:user/:repo/contents/' . $path;
309 | $response = $this->api($apiUrl, array('ref' => $ref));
310 |
311 | if ( is_wp_error($response) || !isset($response->content) || ($response->encoding !== 'base64') ) {
312 | return null;
313 | }
314 | return base64_decode($response->content);
315 | }
316 |
317 | /**
318 | * Parse plugin metadata from the header comment.
319 | * This is basically a simplified version of the get_file_data() function from /wp-includes/functions.php.
320 | *
321 | * @param $content
322 | * @return array
323 | */
324 | protected function getFileHeader($content) {
325 | $headers = array(
326 | 'Name' => 'Plugin Name',
327 | 'PluginURI' => 'Plugin URI',
328 | 'Version' => 'Version',
329 | 'Description' => 'Description',
330 | 'Author' => 'Author',
331 | 'AuthorURI' => 'Author URI',
332 | 'TextDomain' => 'Text Domain',
333 | 'DomainPath' => 'Domain Path',
334 | 'Network' => 'Network',
335 |
336 | //The newest WordPress version that this plugin requires or has been tested with.
337 | //We support several different formats for compatibility with other libraries.
338 | 'Tested WP' => 'Tested WP',
339 | 'Requires WP' => 'Requires WP',
340 | 'Tested up to' => 'Tested up to',
341 | 'Requires at least' => 'Requires at least',
342 | );
343 |
344 | $content = str_replace("\r", "\n", $content); //Normalize line endings.
345 | $results = array();
346 | foreach ($headers as $field => $name) {
347 | $success = preg_match('/^[ \t\/*#@]*' . preg_quote($name, '/') . ':(.*)$/mi', $content, $matches);
348 | if ( ($success === 1) && $matches[1] ) {
349 | $results[$field] = _cleanup_header_comment($matches[1]);
350 | } else {
351 | $results[$field] = '';
352 | }
353 | }
354 |
355 | return $results;
356 | }
357 |
358 | /**
359 | * Copy plugin metadata from a file header to a PluginInfo object.
360 | *
361 | * @param array $fileHeader
362 | * @param PluginInfo_3_1 $pluginInfo
363 | */
364 | protected function setInfoFromHeader($fileHeader, $pluginInfo) {
365 | $headerToPropertyMap = array(
366 | 'Version' => 'version',
367 | 'Name' => 'name',
368 | 'PluginURI' => 'homepage',
369 | 'Author' => 'author',
370 | 'AuthorName' => 'author',
371 | 'AuthorURI' => 'author_homepage',
372 |
373 | 'Requires WP' => 'requires',
374 | 'Tested WP' => 'tested',
375 | 'Requires at least' => 'requires',
376 | 'Tested up to' => 'tested',
377 | );
378 | foreach ($headerToPropertyMap as $headerName => $property) {
379 | if ( isset($fileHeader[$headerName]) && !empty($fileHeader[$headerName]) ) {
380 | $pluginInfo->$property = $fileHeader[$headerName];
381 | }
382 | }
383 |
384 | if ( !empty($fileHeader['Description']) ) {
385 | $pluginInfo->sections['description'] = $fileHeader['Description'];
386 | }
387 | }
388 |
389 | /**
390 | * Copy plugin metadata from the remote readme.txt file.
391 | *
392 | * @param string $ref GitHub tag or branch where to look for the readme.
393 | * @param PluginInfo_3_1 $pluginInfo
394 | */
395 | protected function setInfoFromRemoteReadme($ref, $pluginInfo) {
396 | $readmeTxt = $this->getRemoteFile('readme.txt', $ref);
397 | if ( empty($readmeTxt) ) {
398 | return;
399 | }
400 |
401 | $readme = $this->parseReadme($readmeTxt);
402 |
403 | if ( isset($readme['sections']) ) {
404 | $pluginInfo->sections = array_merge($pluginInfo->sections, $readme['sections']);
405 | }
406 | if ( !empty($readme['tested_up_to']) ) {
407 | $pluginInfo->tested = $readme['tested_up_to'];
408 | }
409 | if ( !empty($readme['requires_at_least']) ) {
410 | $pluginInfo->requires = $readme['requires_at_least'];
411 | }
412 |
413 | if ( isset($readme['upgrade_notice'], $readme['upgrade_notice'][$pluginInfo->version]) ) {
414 | $pluginInfo->upgrade_notice = $readme['upgrade_notice'][$pluginInfo->version];
415 | }
416 | }
417 |
418 | protected function parseReadme($content) {
419 | if ( !class_exists('PucReadmeParser', false) ) {
420 | require_once(dirname(__FILE__) . '/vendor/readme-parser.php');
421 | }
422 | $parser = new PucReadmeParser();
423 | return $parser->parse_readme_contents($content);
424 | }
425 |
426 | /**
427 | * Check if the currently installed version has a readme.txt file.
428 | *
429 | * @return bool
430 | */
431 | protected function readmeTxtExistsLocally() {
432 | $pluginDirectory = dirname($this->pluginAbsolutePath);
433 | if ( empty($this->pluginAbsolutePath) || !is_dir($pluginDirectory) || ($pluginDirectory === '.') ) {
434 | return false;
435 | }
436 | return is_file($pluginDirectory . '/readme.txt');
437 | }
438 |
439 | /**
440 | * Generate a URL to download a ZIP archive of the specified branch/tag/etc.
441 | *
442 | * @param string $ref
443 | * @return string
444 | */
445 | protected function buildArchiveDownloadUrl($ref = 'master') {
446 | $url = sprintf(
447 | 'https://api.github.com/repos/%1$s/%2$s/zipball/%3$s',
448 | urlencode($this->userName),
449 | urlencode($this->repositoryName),
450 | urlencode($ref)
451 | );
452 | if ( !empty($this->accessToken) ) {
453 | $url = add_query_arg('access_token', $this->accessToken, $url);
454 | }
455 | return $url;
456 | }
457 | }
458 |
459 | endif;
--------------------------------------------------------------------------------
/includes/plugin-update-checker/js/debug-bar.js:
--------------------------------------------------------------------------------
1 | jQuery(function($) {
2 |
3 | function runAjaxAction(button, action) {
4 | button = $(button);
5 | var panel = button.closest('.puc-debug-bar-panel');
6 | var responseBox = button.closest('td').find('.puc-ajax-response');
7 |
8 | responseBox.text('Processing...').show();
9 | $.post(
10 | ajaxurl,
11 | {
12 | action : action,
13 | slug : panel.data('slug'),
14 | _wpnonce: panel.data('nonce')
15 | },
16 | function(data) {
17 | responseBox.html(data);
18 | },
19 | 'html'
20 | );
21 | }
22 |
23 | $('.puc-debug-bar-panel input[name="puc-check-now-button"]').click(function() {
24 | runAjaxAction(this, 'puc_debug_check_now');
25 | return false;
26 | });
27 |
28 | $('.puc-debug-bar-panel input[name="puc-request-info-button"]').click(function() {
29 | runAjaxAction(this, 'puc_debug_request_info');
30 | return false;
31 | });
32 |
33 |
34 | // Debug Bar uses the panel class name as part of its link and container IDs. This means we can
35 | // end up with multiple identical IDs if more than one plugin uses the update checker library.
36 | // Fix it by replacing the class name with the plugin slug.
37 | var panels = $('#debug-menu-targets').find('.puc-debug-bar-panel');
38 | panels.each(function(index) {
39 | var panel = $(this);
40 | var slug = panel.data('slug');
41 | var target = panel.closest('.debug-menu-target');
42 |
43 | //Change the panel wrapper ID.
44 | target.attr('id', 'debug-menu-target-puc-' + slug);
45 |
46 | //Change the menu link ID as well and point it at the new target ID.
47 | $('#puc-debug-menu-link-' + panel.data('slug'))
48 | .closest('.debug-menu-link')
49 | .attr('id', 'debug-menu-link-puc-' + slug)
50 | .attr('href', '#' + target.attr('id'));
51 | });
52 | });
--------------------------------------------------------------------------------
/includes/plugin-update-checker/languages/plugin-update-checker-fr_FR.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/rbenhase/beaver-brewer/574c03137ac04cb3cdb619d17ecd412d61d0faca/includes/plugin-update-checker/languages/plugin-update-checker-fr_FR.mo
--------------------------------------------------------------------------------
/includes/plugin-update-checker/languages/plugin-update-checker-fr_FR.po:
--------------------------------------------------------------------------------
1 | msgid ""
2 | msgstr ""
3 | "Project-Id-Version: plugin-update-checker\n"
4 | "POT-Creation-Date: 2016-02-17 14:21+0100\n"
5 | "PO-Revision-Date: 2016-02-17 14:22+0100\n"
6 | "Last-Translator: studio RVOLA \n"
7 | "Language-Team: studio RVOLA \n"
8 | "Language: fr_FR\n"
9 | "MIME-Version: 1.0\n"
10 | "Content-Type: text/plain; charset=UTF-8\n"
11 | "Content-Transfer-Encoding: 8bit\n"
12 | "X-Generator: Poedit 1.8.7\n"
13 | "X-Poedit-Basepath: ..\n"
14 | "Plural-Forms: nplurals=2; plural=(n > 1);\n"
15 | "X-Poedit-SourceCharset: UTF-8\n"
16 | "X-Poedit-KeywordsList: __;_e\n"
17 | "X-Poedit-SearchPath-0: .\n"
18 |
19 | #: github-checker.php:120
20 | msgid "There is no changelog available."
21 | msgstr "Il n’y a aucun changelog disponible."
22 |
23 | #: plugin-update-checker.php:637
24 | msgid "Check for updates"
25 | msgstr "Vérifier les mises à jour"
26 |
27 | #: plugin-update-checker.php:681
28 | msgid "This plugin is up to date."
29 | msgstr "Ce plugin est à jour."
30 |
31 | #: plugin-update-checker.php:683
32 | msgid "A new version of this plugin is available."
33 | msgstr "Une nouvelle version de ce plugin est disponible."
34 |
35 | #: plugin-update-checker.php:685
36 | #, php-format
37 | msgid "Unknown update checker status \"%s\""
38 | msgstr "Un problème inconnu est survenu \"%s\""
39 |
--------------------------------------------------------------------------------
/includes/plugin-update-checker/languages/plugin-update-checker-hu_HU.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/rbenhase/beaver-brewer/574c03137ac04cb3cdb619d17ecd412d61d0faca/includes/plugin-update-checker/languages/plugin-update-checker-hu_HU.mo
--------------------------------------------------------------------------------
/includes/plugin-update-checker/languages/plugin-update-checker-hu_HU.po:
--------------------------------------------------------------------------------
1 | msgid ""
2 | msgstr ""
3 | "Project-Id-Version: plugin-update-checker\n"
4 | "POT-Creation-Date: 2016-01-11 21:23+0100\n"
5 | "PO-Revision-Date: 2016-01-11 21:25+0100\n"
6 | "Last-Translator: Tamás András Horváth \n"
7 | "Language-Team: \n"
8 | "Language: hu_HU\n"
9 | "MIME-Version: 1.0\n"
10 | "Content-Type: text/plain; charset=UTF-8\n"
11 | "Content-Transfer-Encoding: 8bit\n"
12 | "X-Generator: Poedit 1.8.6\n"
13 | "X-Poedit-Basepath: ..\n"
14 | "Plural-Forms: nplurals=2; plural=(n != 1);\n"
15 | "X-Poedit-SourceCharset: UTF-8\n"
16 | "X-Poedit-KeywordsList: __;_e\n"
17 | "X-Poedit-SearchPath-0: .\n"
18 |
19 | #: github-checker.php:137
20 | msgid "There is no changelog available."
21 | msgstr "Nem érhető el a changelog."
22 |
23 | #: plugin-update-checker.php:852
24 | msgid "Check for updates"
25 | msgstr "Frissítés ellenőrzése"
26 |
27 | #: plugin-update-checker.php:896
28 | msgid "This plugin is up to date."
29 | msgstr "Ez a plugin naprakész."
30 |
31 | #: plugin-update-checker.php:898
32 | msgid "A new version of this plugin is available."
33 | msgstr "Új verzió érhető el a kiegészítőhöz"
34 |
35 | #: plugin-update-checker.php:900
36 | #, php-format
37 | msgid "Unknown update checker status \"%s\""
38 | msgstr "Ismeretlen a frissítés ellenőrző státusza \"%s\""
39 |
40 | #~ msgid "Every %d hours"
41 | #~ msgstr "Minden %d órában"
42 |
--------------------------------------------------------------------------------
/includes/plugin-update-checker/languages/plugin-update-checker.pot:
--------------------------------------------------------------------------------
1 | #, fuzzy
2 | msgid ""
3 | msgstr ""
4 | "Project-Id-Version: plugin-update-checker\n"
5 | "POT-Creation-Date: 2016-01-11 21:22+0100\n"
6 | "PO-Revision-Date: 2016-01-10 20:59+0100\n"
7 | "Last-Translator: Tamás András Horváth \n"
8 | "Language-Team: \n"
9 | "Language: en_US\n"
10 | "MIME-Version: 1.0\n"
11 | "Content-Type: text/plain; charset=UTF-8\n"
12 | "Content-Transfer-Encoding: 8bit\n"
13 | "X-Generator: Poedit 1.8.6\n"
14 | "X-Poedit-Basepath: ..\n"
15 | "Plural-Forms: nplurals=2; plural=(n != 1);\n"
16 | "X-Poedit-SourceCharset: UTF-8\n"
17 | "X-Poedit-KeywordsList: __;_e\n"
18 | "X-Poedit-SearchPath-0: .\n"
19 |
20 | #: github-checker.php:137
21 | msgid "There is no changelog available."
22 | msgstr ""
23 |
24 | #: plugin-update-checker.php:852
25 | msgid "Check for updates"
26 | msgstr ""
27 |
28 | #: plugin-update-checker.php:896
29 | msgid "This plugin is up to date."
30 | msgstr ""
31 |
32 | #: plugin-update-checker.php:898
33 | msgid "A new version of this plugin is available."
34 | msgstr ""
35 |
36 | #: plugin-update-checker.php:900
37 | #, php-format
38 | msgid "Unknown update checker status \"%s\""
39 | msgstr ""
40 |
--------------------------------------------------------------------------------
/includes/plugin-update-checker/license.txt:
--------------------------------------------------------------------------------
1 | Copyright (c) 2014 Jānis Elsts
2 |
3 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4 |
5 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6 |
7 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
--------------------------------------------------------------------------------
/includes/plugin-update-checker/vendor/readme-parser.php:
--------------------------------------------------------------------------------
1 | parse_readme_contents( $file_contents );
17 | }
18 |
19 | function parse_readme_contents( $file_contents ) {
20 | $file_contents = str_replace(array("\r\n", "\r"), "\n", $file_contents);
21 | $file_contents = trim($file_contents);
22 | if ( 0 === strpos( $file_contents, "\xEF\xBB\xBF" ) )
23 | $file_contents = substr( $file_contents, 3 );
24 |
25 | // Markdown transformations
26 | $file_contents = preg_replace( "|^###([^#]+)#*?\s*?\n|im", '=$1='."\n", $file_contents );
27 | $file_contents = preg_replace( "|^##([^#]+)#*?\s*?\n|im", '==$1=='."\n", $file_contents );
28 | $file_contents = preg_replace( "|^#([^#]+)#*?\s*?\n|im", '===$1==='."\n", $file_contents );
29 |
30 | // === Plugin Name ===
31 | // Must be the very first thing.
32 | if ( !preg_match('|^===(.*)===|', $file_contents, $_name) )
33 | return array(); // require a name
34 | $name = trim($_name[1], '=');
35 | $name = $this->sanitize_text( $name );
36 |
37 | $file_contents = $this->chop_string( $file_contents, $_name[0] );
38 |
39 |
40 | // Requires at least: 1.5
41 | if ( preg_match('|Requires at least:(.*)|i', $file_contents, $_requires_at_least) )
42 | $requires_at_least = $this->sanitize_text($_requires_at_least[1]);
43 | else
44 | $requires_at_least = NULL;
45 |
46 |
47 | // Tested up to: 2.1
48 | if ( preg_match('|Tested up to:(.*)|i', $file_contents, $_tested_up_to) )
49 | $tested_up_to = $this->sanitize_text( $_tested_up_to[1] );
50 | else
51 | $tested_up_to = NULL;
52 |
53 |
54 | // Stable tag: 10.4-ride-the-fire-eagle-danger-day
55 | if ( preg_match('|Stable tag:(.*)|i', $file_contents, $_stable_tag) )
56 | $stable_tag = $this->sanitize_text( $_stable_tag[1] );
57 | else
58 | $stable_tag = NULL; // we assume trunk, but don't set it here to tell the difference between specified trunk and default trunk
59 |
60 |
61 | // Tags: some tag, another tag, we like tags
62 | if ( preg_match('|Tags:(.*)|i', $file_contents, $_tags) ) {
63 | $tags = preg_split('|,[\s]*?|', trim($_tags[1]));
64 | foreach ( array_keys($tags) as $t )
65 | $tags[$t] = $this->sanitize_text( $tags[$t] );
66 | } else {
67 | $tags = array();
68 | }
69 |
70 |
71 | // Contributors: markjaquith, mdawaffe, zefrank
72 | $contributors = array();
73 | if ( preg_match('|Contributors:(.*)|i', $file_contents, $_contributors) ) {
74 | $temp_contributors = preg_split('|,[\s]*|', trim($_contributors[1]));
75 | foreach ( array_keys($temp_contributors) as $c ) {
76 | $tmp_sanitized = $this->user_sanitize( $temp_contributors[$c] );
77 | if ( strlen(trim($tmp_sanitized)) > 0 )
78 | $contributors[$c] = $tmp_sanitized;
79 | unset($tmp_sanitized);
80 | }
81 | }
82 |
83 |
84 | // Donate Link: URL
85 | if ( preg_match('|Donate link:(.*)|i', $file_contents, $_donate_link) )
86 | $donate_link = esc_url( $_donate_link[1] );
87 | else
88 | $donate_link = NULL;
89 |
90 |
91 | // togs, conts, etc are optional and order shouldn't matter. So we chop them only after we've grabbed their values.
92 | foreach ( array('tags', 'contributors', 'requires_at_least', 'tested_up_to', 'stable_tag', 'donate_link') as $chop ) {
93 | if ( $$chop ) {
94 | $_chop = '_' . $chop;
95 | $file_contents = $this->chop_string( $file_contents, ${$_chop}[0] );
96 | }
97 | }
98 |
99 | $file_contents = trim($file_contents);
100 |
101 |
102 | // short-description fu
103 | if ( !preg_match('/(^(.*?))^[\s]*=+?[\s]*.+?[\s]*=+?/ms', $file_contents, $_short_description) )
104 | $_short_description = array( 1 => &$file_contents, 2 => &$file_contents );
105 | $short_desc_filtered = $this->sanitize_text( $_short_description[2] );
106 | $short_desc_length = strlen($short_desc_filtered);
107 | $short_description = substr($short_desc_filtered, 0, 150);
108 | if ( $short_desc_length > strlen($short_description) )
109 | $truncated = true;
110 | else
111 | $truncated = false;
112 | if ( $_short_description[1] )
113 | $file_contents = $this->chop_string( $file_contents, $_short_description[1] ); // yes, the [1] is intentional
114 |
115 | // == Section ==
116 | // Break into sections
117 | // $_sections[0] will be the title of the first section, $_sections[1] will be the content of the first section
118 | // the array alternates from there: title2, content2, title3, content3... and so forth
119 | $_sections = preg_split('/^[\s]*==[\s]*(.+?)[\s]*==/m', $file_contents, -1, PREG_SPLIT_DELIM_CAPTURE|PREG_SPLIT_NO_EMPTY);
120 |
121 | $sections = array();
122 | for ( $i=1; $i <= count($_sections); $i +=2 ) {
123 | $_sections[$i] = preg_replace('/^[\s]*=[\s]+(.+?)[\s]+=/m', '$1
', $_sections[$i]);
124 | $_sections[$i] = $this->filter_text( $_sections[$i], true );
125 | $title = $this->sanitize_text( $_sections[$i-1] );
126 | $sections[str_replace(' ', '_', strtolower($title))] = array('title' => $title, 'content' => $_sections[$i]);
127 | }
128 |
129 |
130 | // Special sections
131 | // This is where we nab our special sections, so we can enforce their order and treat them differently, if needed
132 | // upgrade_notice is not a section, but parse it like it is for now
133 | $final_sections = array();
134 | foreach ( array('description', 'installation', 'frequently_asked_questions', 'screenshots', 'changelog', 'change_log', 'upgrade_notice') as $special_section ) {
135 | if ( isset($sections[$special_section]) ) {
136 | $final_sections[$special_section] = $sections[$special_section]['content'];
137 | unset($sections[$special_section]);
138 | }
139 | }
140 | if ( isset($final_sections['change_log']) && empty($final_sections['changelog']) )
141 | $final_sections['changelog'] = $final_sections['change_log'];
142 |
143 |
144 | $final_screenshots = array();
145 | if ( isset($final_sections['screenshots']) ) {
146 | preg_match_all('|(.*?)|s', $final_sections['screenshots'], $screenshots, PREG_SET_ORDER);
147 | if ( $screenshots ) {
148 | foreach ( (array) $screenshots as $ss )
149 | $final_screenshots[] = $ss[1];
150 | }
151 | }
152 |
153 | // Parse the upgrade_notice section specially:
154 | // 1.0 => blah, 1.1 => fnord
155 | $upgrade_notice = array();
156 | if ( isset($final_sections['upgrade_notice']) ) {
157 | $split = preg_split( '#(.*?)
#', $final_sections['upgrade_notice'], -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY );
158 | for ( $i = 0; $i < count( $split ); $i += 2 )
159 | $upgrade_notice[$this->sanitize_text( $split[$i] )] = substr( $this->sanitize_text( $split[$i + 1] ), 0, 300 );
160 | unset( $final_sections['upgrade_notice'] );
161 | }
162 |
163 | // No description?
164 | // No problem... we'll just fall back to the old style of description
165 | // We'll even let you use markup this time!
166 | $excerpt = false;
167 | if ( !isset($final_sections['description']) ) {
168 | $final_sections = array_merge(array('description' => $this->filter_text( $_short_description[2], true )), $final_sections);
169 | $excerpt = true;
170 | }
171 |
172 |
173 | // dump the non-special sections into $remaining_content
174 | // their order will be determined by their original order in the readme.txt
175 | $remaining_content = '';
176 | foreach ( $sections as $s_name => $s_data ) {
177 | $remaining_content .= "\n{$s_data['title']}
\n{$s_data['content']}";
178 | }
179 | $remaining_content = trim($remaining_content);
180 |
181 |
182 | // All done!
183 | // $r['tags'] and $r['contributors'] are simple arrays
184 | // $r['sections'] is an array with named elements
185 | $r = array(
186 | 'name' => $name,
187 | 'tags' => $tags,
188 | 'requires_at_least' => $requires_at_least,
189 | 'tested_up_to' => $tested_up_to,
190 | 'stable_tag' => $stable_tag,
191 | 'contributors' => $contributors,
192 | 'donate_link' => $donate_link,
193 | 'short_description' => $short_description,
194 | 'screenshots' => $final_screenshots,
195 | 'is_excerpt' => $excerpt,
196 | 'is_truncated' => $truncated,
197 | 'sections' => $final_sections,
198 | 'remaining_content' => $remaining_content,
199 | 'upgrade_notice' => $upgrade_notice
200 | );
201 |
202 | return $r;
203 | }
204 |
205 | function chop_string( $string, $chop ) { // chop a "prefix" from a string: Agressive! uses strstr not 0 === strpos
206 | if ( $_string = strstr($string, $chop) ) {
207 | $_string = substr($_string, strlen($chop));
208 | return trim($_string);
209 | } else {
210 | return trim($string);
211 | }
212 | }
213 |
214 | function user_sanitize( $text, $strict = false ) { // whitelisted chars
215 | if ( function_exists('user_sanitize') ) // bbPress native
216 | return user_sanitize( $text, $strict );
217 |
218 | if ( $strict ) {
219 | $text = preg_replace('/[^a-z0-9-]/i', '', $text);
220 | $text = preg_replace('|-+|', '-', $text);
221 | } else {
222 | $text = preg_replace('/[^a-z0-9_-]/i', '', $text);
223 | }
224 | return $text;
225 | }
226 |
227 | function sanitize_text( $text ) { // not fancy
228 | $text = strip_tags($text);
229 | $text = esc_html($text);
230 | $text = trim($text);
231 | return $text;
232 | }
233 |
234 | function filter_text( $text, $markdown = false ) { // fancy, Markdown
235 | $text = trim($text);
236 |
237 | $text = call_user_func( array( __CLASS__, 'code_trick' ), $text, $markdown ); // A better parser than Markdown's for: backticks -> CODE
238 |
239 | if ( $markdown ) { // Parse markdown.
240 | if ( !class_exists('Parsedown', false) ) {
241 | require_once(dirname(__FILE__) . '/Parsedown' . (version_compare(PHP_VERSION, '5.3.0', '>=') ? '' : 'Legacy') . '.php');
242 | }
243 | $instance = Parsedown::instance();
244 | $text = $instance->text($text);
245 | }
246 |
247 | $allowed = array(
248 | 'a' => array(
249 | 'href' => array(),
250 | 'title' => array(),
251 | 'rel' => array()),
252 | 'blockquote' => array('cite' => array()),
253 | 'br' => array(),
254 | 'p' => array(),
255 | 'code' => array(),
256 | 'pre' => array(),
257 | 'em' => array(),
258 | 'strong' => array(),
259 | 'ul' => array(),
260 | 'ol' => array(),
261 | 'li' => array(),
262 | 'h3' => array(),
263 | 'h4' => array()
264 | );
265 |
266 | $text = balanceTags($text);
267 |
268 | $text = wp_kses( $text, $allowed );
269 | $text = trim($text);
270 | return $text;
271 | }
272 |
273 | function code_trick( $text, $markdown ) { // Don't use bbPress native function - it's incompatible with Markdown
274 | // If doing markdown, first take any user formatted code blocks and turn them into backticks so that
275 | // markdown will preserve things like underscores in code blocks
276 | if ( $markdown )
277 | $text = preg_replace_callback("!(|)(.*?)(
|)!s", array( __CLASS__,'decodeit'), $text);
278 |
279 | $text = str_replace(array("\r\n", "\r"), "\n", $text);
280 | if ( !$markdown ) {
281 | // This gets the "inline" code blocks, but can't be used with Markdown.
282 | $text = preg_replace_callback("|(`)(.*?)`|", array( __CLASS__, 'encodeit'), $text);
283 | // This gets the "block level" code blocks and converts them to PRE CODE
284 | $text = preg_replace_callback("!(^|\n)`(.*?)`!s", array( __CLASS__, 'encodeit'), $text);
285 | } else {
286 | // Markdown can do inline code, we convert bbPress style block level code to Markdown style
287 | $text = preg_replace_callback("!(^|\n)([ \t]*?)`(.*?)`!s", array( __CLASS__, 'indent'), $text);
288 | }
289 | return $text;
290 | }
291 |
292 | function indent( $matches ) {
293 | $text = $matches[3];
294 | $text = preg_replace('|^|m', $matches[2] . ' ', $text);
295 | return $matches[1] . $text;
296 | }
297 |
298 | function encodeit( $matches ) {
299 | if ( function_exists('encodeit') ) // bbPress native
300 | return encodeit( $matches );
301 |
302 | $text = trim($matches[2]);
303 | $text = htmlspecialchars($text, ENT_QUOTES);
304 | $text = str_replace(array("\r\n", "\r"), "\n", $text);
305 | $text = preg_replace("|\n\n\n+|", "\n\n", $text);
306 | $text = str_replace('<', '<', $text);
307 | $text = str_replace('>', '>', $text);
308 | $text = "$text";
309 | if ( "`" != $matches[1] )
310 | $text = "$text
";
311 | return $text;
312 | }
313 |
314 | function decodeit( $matches ) {
315 | if ( function_exists('decodeit') ) // bbPress native
316 | return decodeit( $matches );
317 |
318 | $text = $matches[2];
319 | $trans_table = array_flip(get_html_translation_table(HTML_ENTITIES));
320 | $text = strtr($text, $trans_table);
321 | $text = str_replace('
', '', $text);
322 | $text = str_replace('&', '&', $text);
323 | $text = str_replace(''', "'", $text);
324 | if ( '' == $matches[1] )
325 | $text = "\n$text\n";
326 | return "`$text`";
327 | }
328 |
329 | } // end class
330 |
331 | Class Automattic_Readme extends PucReadmeParser {}
332 |
--------------------------------------------------------------------------------
/index.php:
--------------------------------------------------------------------------------
1 |
22 | */
23 | class Beaver_Brewer_Public {
24 |
25 | /**
26 | * The ID of this plugin.
27 | *
28 | * @since 0.1.0
29 | * @access private
30 | * @var string $plugin_name The ID of this plugin.
31 | */
32 | private $plugin_name;
33 |
34 | /**
35 | * The version of this plugin.
36 | *
37 | * @since 0.1.0
38 | * @access private
39 | * @var string $version The current version of this plugin.
40 | */
41 | private $version;
42 |
43 | /**
44 | * All modules and their relevant data.
45 | *
46 | * @since 0.1.0
47 | * @access private
48 | * @var array $modules All recognized modules.
49 | */
50 | private $modules;
51 |
52 |
53 | /**
54 | * Initialize the class and set its properties.
55 | *
56 | * @since 0.1.0
57 | * @param string $plugin_name The name of this plugin.
58 | * @param string $version The version of this plugin.
59 | * @param Beaver_Brewer $brewer An instance of the main Beaver Brewer class.
60 | */
61 | public function __construct( $plugin_name, $version, $modules ) {
62 |
63 | $this->plugin_name = $plugin_name;
64 | $this->version = $version;
65 | $this->modules = $modules;
66 | }
67 |
68 |
69 | /**
70 | * Register modules so they can be used in Beaver Builder.
71 | *
72 | * @since 0.1.0
73 | */
74 | public function register_modules() {
75 |
76 | // Ensure required Beaver Builder class exists
77 | if ( class_exists( 'FLBuilder' ) && isset( $this->modules ) ) {
78 |
79 | // First load other modules to check for compatibility issues
80 | $active_modules = Beaver_Brewer::get_modules_active();
81 |
82 | foreach ( $active_modules as $active_module ) {
83 |
84 | // Require all PHP files in main directory
85 | $path = MY_MODULES_DIR . $active_module;
86 | $files = glob( $path . '/*.php' );
87 | if ( !empty( $files ) ) foreach ( $files as $file_path ){
88 | require_once( $file_path );
89 | }
90 | }
91 | }
92 | }
93 | }
94 |
--------------------------------------------------------------------------------
/public/index.php:
--------------------------------------------------------------------------------
1 |