Purpose
Replace or modify the query for a specific template object programmatically, allowing dynamic adjustments to the data source.
Usage
add_filter( "wr_template_object_replace_query", array( $this, "my_template_object_replace_query" ), 10, 3 );Parameters
- $query_identifier (string): The current query identifier used by the template object.
- $options (array): Additional options passed to the template.
- $selector (array): A selector for targeting specific parts of the template.
Use Case
This functionality is useful when:
- You need to dynamically switch the query source for a specific template object.
Implementation Example
add_filter( "wr_template_object_replace_query", array( $this, "my_template_object_replace_query" ), 10, 3 );
 
public function my_template_object_replace_query( $query_identifier, $options = array(), $selector = array() ) {
	if ( !empty($options["identifier"] && $options["identifier"] === "my_template_object_identifier" ) ) {
		return "my_query_identifier";
	}
	return $query_identifier;
}