namespace Elementor\Modules\Usage;
use Elementor\Modules\System_Info\Reporters\Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
* Elementor usage report.
* Elementor system report handler class responsible for generating a report for
class Usage_Reporter extends Base {
const RECALC_ACTION = 'elementor_usage_recalc';
public function get_title() {
return esc_html__( 'Elements Usage', 'elementor' );
public function get_fields() {
public function print_html_label( $label ) {
$title = $this->get_title();
if ( empty( $_GET[ self::RECALC_ACTION ] ) ) { // phpcs:ignore -- nonce validation is not required here.
$nonce = wp_create_nonce( self::RECALC_ACTION );
self::RECALC_ACTION => 1,
$title .= '<a id="elementor-usage-recalc" href="' . esc_url( $url ) . '#elementor-usage-recalc" class="box-title-tool">Recalculate</a>';
$title .= $this->get_remove_recalc_query_string_script();
parent::print_html_label( $title );
public function get_usage() {
/** @var Module $module */
$module = Module::instance();
if ( ! empty( $_GET[ self::RECALC_ACTION ] ) ) {
$nonce = Utils::get_super_global_value( $_GET, '_wpnonce' );
if ( ! wp_verify_nonce( $nonce, self::RECALC_ACTION ) ) {
wp_die( 'Invalid Nonce', 'Invalid Nonce', [
foreach ( $module->get_formatted_usage() as $doc_type => $data ) {
$usage .= '<tr><td>' . $data['title'] . ' ( ' . $data['count'] . ' )</td><td>';
foreach ( $data['elements'] as $element => $count ) {
$usage .= $element . ': ' . $count . PHP_EOL;
public function get_raw_usage() {
/** @var Module $module */
$module = Module::instance();
foreach ( $module->get_formatted_usage( 'raw' ) as $doc_type => $data ) {
$usage .= "\t{$data['title']} : " . $data['count'] . PHP_EOL;
foreach ( $data['elements'] as $element => $count ) {
$usage .= "\t\t{$element} : {$count}" . PHP_EOL;
* Removes the "elementor_usage_recalc" param from the query string to avoid recalc every refresh.
* When using a redirect header in place of this approach it throws an error because some components have already output some content.
private function get_remove_recalc_query_string_script() {
// Origin file: modules/usage/usage-reporter.php - get_remove_recalc_query_string_script()
const url = new URL( window.location );
url.searchParams.delete( 'elementor_usage_recalc' );
url.searchParams.delete( '_wpnonce' );
history.replaceState( '', window.title, url.toString() );