Custom Data (Pro)

The page below describes the Custom Data feature for Card. You can read about the Custom Data feature for View here.

About the feature

Using the Custom Data feature you can add extra arguments to the Card query, and extra variables to the Card template.

1. Custom query arguments

Card provides a user interface for all the main WP_Query arguments. However, to avoid overloading the user interface, we haven't included all possible arguments.

In advanced cases, you may need to use arguments that are missing from the UI. In the Pro version, you can achieve this by using the Custom Data feature, which can be found under the Advanced tab of your Card settings.

This feature allows you to extend the current Card WP_Query arguments by merging them with arguments returned from a custom PHP snippet. The data return should return an associative array, which will be merged with the settings from the UI.

2. Custom template arguments

Using this feature, you can also add any custom variables to your Card template.

Tip: Use the custom template arguments only for data that isn't supported by Advanced Views.

Bad use case: your Card queries posts of the current user, and you need to display a user name in top of the list. Instead of creating a new View for displaying the user info, and pasting View's shortcode to the Card template, you use the custom template arguments.

Good use case: your Card queries WooCommerce Products by specific author (seller), and you need to display a live seller's rate that is deducted dynamically, and not available in the User meta.

Custom Data snippet

The field with the snippet can be found in the Advanced tab of your Card.

The snippet is a PHP code, which must return an instance of the Custom_Card_Data class.

• using the get_variables() method you can pass custom variables to the Card template

• using the get_query_arguments() method you can pass custom arguments to the Card query

• using the get_custom_arguments() method you can access the custom arguments passed to the shortcode. The field is available in the both methods above.

• using the get_default_variables() method you can access to the default twig variables (that filled out automatically by the plugin)

• using the get_default_query_arguments() method you can access to the default query arguments (that filled out automatically by the plugin)

<?php

declare(strict_types=1);

use Org\Wplake\Advanced_Views\Pro\Bridge\Cards\Custom_Card_Data;

return new class extends Custom_Card_Data {
    /**
     * @return array<string,mixed>
     */
    public function get_variables(): array
    {
        return [
            // "another_var" => $this->get_custom_arguments()["another"] ?? "",
        ];
    }

    /**
     * @return array<string,mixed>
     */
    public function get_variables_for_validation(): array
    {
        // it's to return dummy data here [ "another_var" => "dummy string", ]
        return $this->get_variables();
    }

    public function get_query_arguments(): array
    {
        // https://developer.wordpress.org/reference/classes/wp_query/#parameters
        return [
            // "author" => get_current_user_id(),
            // "post_parent" => $this->get_custom_arguments()["post_parent"] ?? 0,
        ];
    }
};

Tip: if you pass custom variables using the get_variables() method, we recommend to change the get_variables_for_validation() method and return dummy data there.

Advanced Views has the built-in automatic template validation, which called on the Save action. There is no sense to return real data in this case, and it's better to return dummy data, to avoid potential issues with missing functions.

For example, if you use WP functions inside, they may be front-end only, and aren't available in the wp-admin area, which will lead to the failed validation.