Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
30.99% covered (danger)
30.99%
22 / 71
16.67% covered (danger)
16.67%
1 / 6
CRAP
0.00% covered (danger)
0.00%
0 / 1
CLI
30.99% covered (danger)
30.99%
22 / 71
16.67% covered (danger)
16.67%
1 / 6
230.44
0.00% covered (danger)
0.00%
0 / 1
 __construct
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 module
57.14% covered (warning)
57.14%
8 / 14
0.00% covered (danger)
0.00%
0 / 1
6.97
 getting_started
0.00% covered (danger)
0.00%
0 / 9
0.00% covered (danger)
0.00%
0 / 1
6
 set_module_status
54.17% covered (warning)
54.17%
13 / 24
0.00% covered (danger)
0.00%
0 / 1
16.80
 connection
0.00% covered (danger)
0.00%
0 / 20
0.00% covered (danger)
0.00%
0 / 1
56
 reset
0.00% covered (danger)
0.00%
0 / 3
0.00% covered (danger)
0.00%
0 / 1
2
1<?php
2/**
3 * CLI commands for Jetpack Boost.
4 *
5 * @link       https://automattic.com
6 * @since      1.0.0
7 * @package    automattic/jetpack-boost
8 */
9
10namespace Automattic\Jetpack_Boost\Lib;
11
12use Automattic\Jetpack_Boost\Data_Sync\Getting_Started_Entry;
13use Automattic\Jetpack_Boost\Modules\Module;
14use Automattic\Jetpack_Boost\Modules\Modules_Setup;
15use Automattic\Jetpack_Boost\Modules\Optimizations\Page_Cache\Page_Cache;
16use Automattic\Jetpack_Boost\Modules\Optimizations\Page_Cache\Page_Cache_Setup;
17use Automattic\Jetpack_Boost\Modules\Optimizations\Page_Cache\Pre_WordPress\Boost_Cache_Error;
18
19/**
20 * Control your local Jetpack Boost installation.
21 */
22class CLI {
23
24    /**
25     * Jetpack Boost plugin.
26     *
27     * @var \Automattic\Jetpack_Boost\Jetpack_Boost $jetpack_boost
28     */
29    private $jetpack_boost;
30
31    const MAKE_E2E_TESTS_WORK_MODULES = array( 'critical_css', 'speculation_rules', 'render_blocking_js', 'page_cache', 'lcp', 'minify_js', 'minify_css', 'image_cdn', 'image_guide' );
32
33    /**
34     * CLI constructor.
35     *
36     * @param \Automattic\Jetpack_Boost\Jetpack_Boost $jetpack_boost Jetpack Boost plugin.
37     */
38    public function __construct( $jetpack_boost ) {
39        $this->jetpack_boost = $jetpack_boost;
40    }
41
42    /**
43     * Manage Jetpack Boost Modules
44     *
45     * ## OPTIONS
46     *
47     * <activate|deactivate>
48     * : The action to take.
49     * ---
50     * options:
51     *  - activate
52     *  - deactivate
53     * ---
54     *
55     * [<module_slug>]
56     * : The slug of the module to perform an action on.
57     *
58     * ## EXAMPLES
59     *
60     * wp jetpack-boost module activate critical_css
61     * wp jetpack-boost module deactivate critical_css
62     *
63     * @param array $args Command arguments.
64     */
65    public function module( $args ) {
66        $action      = $args[0] ?? null;
67        $module_slug = $args[1] ?? null;
68
69        if ( $module_slug === null ) {
70            /* translators: Placeholder is list of available modules. */
71            \WP_CLI::error( sprintf( __( 'Please specify a valid module. It should be one of %s', 'jetpack-boost' ), wp_json_encode( self::MAKE_E2E_TESTS_WORK_MODULES, JSON_UNESCAPED_SLASHES ) ) );
72        }
73
74        if ( ! in_array( $module_slug, self::MAKE_E2E_TESTS_WORK_MODULES, true ) ) {
75            \WP_CLI::error(
76                /* translators: %1$s refers to the module slug like 'critical-css', %2$s is the list of available modules. */
77                sprintf( __( "The '%1\$s' module slug is invalid. It should be one of %2\$s", 'jetpack-boost' ), $module_slug, wp_json_encode( self::MAKE_E2E_TESTS_WORK_MODULES, JSON_UNESCAPED_SLASHES ) )
78            );
79        }
80
81        switch ( $action ) {
82            case 'activate':
83                $this->set_module_status( $module_slug, true );
84                break;
85            case 'deactivate':
86                $this->set_module_status( $module_slug, false );
87                break;
88        }
89    }
90
91    public function getting_started( $args ) {
92        $status = $args[0] ?? null;
93
94        if ( ! in_array( $status, array( 'true', 'false' ), true ) ) {
95            \WP_CLI::error(
96                /* translators: %s refers to the module slug like 'critical-css' */
97                sprintf( __( "The '%s' status is invalid", 'jetpack-boost' ), $status )
98            );
99        }
100
101        ( new Getting_Started_Entry() )->set( 'true' === $status );
102
103        \WP_CLI::success(
104            /* translators: %s refers to 'true' or 'false' */
105            sprintf( __( 'Getting started is set to %s', 'jetpack-boost' ), $status )
106        );
107    }
108
109    /**
110     * Set a module status.
111     *
112     * @param string $module_slug Module slug.
113     * @param string $status      Module status.
114     */
115    private function set_module_status( $module_slug, $status ) {
116        $modules = ( new Modules_Setup() )->get_available_modules_and_submodules();
117        $module  = $modules[ $module_slug ] ?? false;
118        if ( ! ( $module instanceof Module ) ) {
119            \WP_CLI::error(
120                /* translators: %s refers to the module slug like 'critical-css' */
121                sprintf( __( "The '%s' module slug is invalid", 'jetpack-boost' ), $module_slug )
122            );
123        }
124
125        $module->update( $status );
126
127        if ( $module_slug === Page_Cache::get_slug() && ! $status ) {
128            $deactivate_result = $module->on_deactivate();
129            if ( $deactivate_result instanceof Boost_Cache_Error ) {
130                \WP_CLI::error( $deactivate_result->get_error_message() );
131            }
132        }
133
134        if ( $module_slug === 'page_cache' && $status ) {
135            $setup_result = Page_Cache_Setup::enable();
136            if ( is_wp_error( $setup_result ) ) {
137                \WP_CLI::error(
138                    sprintf(
139                        /* translators: %s refers to the error code */
140                        __( 'Setup: %s', 'jetpack-boost' ),
141                        $setup_result->get_error_code()
142                    )
143                );
144            }
145        }
146
147        $status_label = $status ? __( 'activated', 'jetpack-boost' ) : __( 'deactivated', 'jetpack-boost' );
148
149        /* translators: The %1$s refers to the module slug, %2$s refers to the module state (either activated or deactivated)*/
150        \WP_CLI::success(
151            sprintf( __( "'%1\$s' has been %2\$s.", 'jetpack-boost' ), $module_slug, $status_label )
152        );
153    }
154
155    /**
156     * Manage Jetpack Boost connection
157     *
158     * ## OPTIONS
159     *
160     * <activate|deactivate|status>
161     * : The action to take.
162     * ---
163     * options:
164     *  - activate
165     *  - deactivate
166     *  - status
167     * ---
168     *
169     * ## EXAMPLES
170     *
171     * wp jetpack-boost connection activate
172     * wp jetpack-boost connection deactivate
173     * wp jetpack-boost connection status
174     *
175     * @param array $args Command arguments.
176     */
177    public function connection( $args ) {
178        $action = $args[0] ?? null;
179
180        switch ( $action ) {
181            case 'activate':
182                $result = $this->jetpack_boost->connection->register();
183                if ( true === $result ) {
184                    \WP_CLI::success( __( 'Boost is connected to WP.com', 'jetpack-boost' ) );
185                } else {
186                    \WP_CLI::error( __( 'Boost could not be connected to WP.com', 'jetpack-boost' ) );
187                }
188                break;
189            case 'deactivate':
190                require_once ABSPATH . '/wp-admin/includes/plugin.php';
191
192                if ( is_plugin_active_for_network( JETPACK_BOOST_PATH ) ) {
193                    $this->jetpack_boost->connection->deactivate_disconnect_network();
194                } else {
195                    $this->jetpack_boost->connection->disconnect();
196                }
197
198                \WP_CLI::success( __( 'Boost is disconnected from WP.com', 'jetpack-boost' ) );
199                break;
200            case 'status':
201                $is_connected = $this->jetpack_boost->connection->is_connected();
202                if ( $is_connected ) {
203                    \WP_CLI::line( 'connected' );
204                } else {
205                    \WP_CLI::line( 'disconnected' );
206                }
207                break;
208        }
209    }
210
211    /**
212     * Reset Jetpack Boost
213     *
214     * ## EXAMPLE
215     *
216     * wp jetpack-boost reset
217     */
218    public function reset() {
219        $this->jetpack_boost->deactivate();
220        $this->jetpack_boost->uninstall();
221        \WP_CLI::success( 'Reset successfully' );
222    }
223}