: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
* @author Advanced Ads <info@wpadvancedads.com>
* @var array $placement_types placement types.
* @var array[] $placements user-defined placements.
* @var string $orderby how to order placements.
* @var bool $has_placements there are use-defined placements.
use AdvancedAds\Entities;
use AdvancedAds\Framework\Utilities\Params;
defined( 'ABSPATH' ) || exit;
$quick_actions['delete'] = '<a style="cursor: pointer;" class="advads-delete-tag">' . __( 'Delete', 'advanced-ads' ) . '</a>';
$message = Params::get( 'message' );
<h2 style="display: none;"><!-- There needs to be an empty H2 headline at the top of the page so that WordPress can properly position admin notifications --></h2>
if ( 'error' === $message ) :
<div id="message" class="notice notice-error advads-admin-notice inline"><p><?php esc_html_e( 'Couldn’t create the new placement. Please check your form field and whether the name is already in use.', 'advanced-ads' ); ?></p></div>
<?php elseif ( 'updated' === $message ) : ?>
<div id="message" class="notice updated advads-admin-notice inline"><p><?php esc_html_e( 'Placements updated', 'advanced-ads' ); ?></p></div>
$modal_slug = 'placement-new';
if ( ! $has_placements ) :
echo esc_html( Entities::get_placement_description() );
<a href="https://wpadvancedads.com/manual/placements/?utm_source=advanced-ads&utm_medium=link&utm_campaign=placements" target="_blank" class="advads-manual-link"><?php esc_html_e( 'Manual', 'advanced-ads' ); ?></a>
include ADVADS_ABSPATH . 'admin/views/placement-form.php'; // phpcs:ignore PEAR.Files.IncludingFile.UseRequire
'modal_slug' => $modal_slug,
'modal_content' => ob_get_clean(),
'modal_title' => __( 'New Placement', 'advanced-ads' ),
'close_action' => __( 'Save New Placement', 'advanced-ads' ),
'close_form' => 'advads-placements-new-form',
'close_validation' => 'advads_validate_new_form',
$existing_types = array_unique( array_column( $placements, 'type' ) );
do_action( 'advanced-ads-placements-list-before', $placements );
<form method="POST" action="" id="advanced-ads-placements-form">
'display_name' => esc_html__( 'Type', 'advanced-ads' ) . ' / ' . esc_html__( 'Name', 'advanced-ads' ),
'display_name' => esc_html__( 'Output', 'advanced-ads' ),
'display_name' => esc_html__( 'Delivery', 'advanced-ads' ),
<?php if ( isset( $placement_types ) && ! empty( $placement_types ) ) : ?>
<div class="tablenav top hidden advads-toggle-with-filters-button">
<select class="advads_filter_placement_type">
<option value="0"><?php esc_html_e( '- show all types -', 'advanced-ads' ); ?></option>
<?php foreach ( $placement_types as $type_name => $placement_type ) : ?>
<?php if ( in_array( $type_name, $existing_types, true ) ) : ?>
<option value="<?php echo esc_attr( $type_name ); ?>"><?php echo esc_html( $placement_type['title'] ); ?></option>
<input type="text" class="advads_search_placement_name" placeholder="<?php esc_html_e( 'filter by name', 'advanced-ads' ); ?>"/>
<table class="wp-list-table advads-placements-table widefat posts advads-table">
foreach ( $columns as $column ) {
$column_display_name = $column['display_name'];
if ( 'type_name' === $column['key'] ) :
list ( $order_type, $name ) = explode( '/', $column_display_name );
'<th class="column-primary"><a href="#" class="advads-sort ' . ( 'type' === $orderby ? 'advads-placement-sorted' : '' ) . '"
data-orderby="type" data-dir="asc">%1$s %2$s</a> / <a href="#" class="advads-sort ' . ( 'name' === $orderby ? 'advads-placement-sorted' : '' ) . '"
data-orderby="name" data-dir="asc" style="margin-left:9px;">%3$s %2$s<a/></th>',
'<span class="advads-placement-sorting-indicator"></span>',
echo '<th>' . esc_html( $column_display_name ) . '</th>';
if ( false && ! empty( $column['custom_sort'] ) ) :
$column_display_name = '<a href="#" class="advads-sort"
data-orderby="name" data-dir="asc">
' . $column_display_name . '
<span class="advads-placement-sorting-indicator"></span></a>';
do_action( 'advanced-ads-placements-list-column-header' ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
$placements = Advanced_Ads_Placements::sort( $placements, $orderby );
$display_conditions = Advanced_Ads_Display_Conditions::get_instance();
$visitor_conditions = Advanced_Ads_Visitor_Conditions::get_instance();
foreach ( $placements as $_placement_slug => $_placement ) :
unset( $quick_actions['usage'] );
if ( isset( $_placement['type'] ) && ! isset( $placement_types[ $_placement['type'] ] ) ) {
$missed_type = $_placement['type'];
$_placement['type'] = 'default';
if ( ( $_placement['type'] ?? 'default' ) === 'default' ) {
$_placement['type'] = 'default';
$quick_actions['usage'] = '<a href="#modal-' . esc_attr( $_placement_slug ) . '-usage" class="usage-modal-link">' . esc_html__( 'show usage', 'advanced-ads' ) . '</a>';
do_action( 'advanced-ads-placement-options-before-advanced', $_placement_slug, $_placement );
if ( 'header' !== $_placement['type'] ) :
$type_options = isset( $placement_types[ $_placement['type'] ]['options'] ) ? $placement_types[ $_placement['type'] ]['options'] : [];
if ( ! isset( $type_options['placement-ad-label'] ) || $type_options['placement-ad-label'] ) {
$_label = isset( $_placement['options']['ad_label'] ) ? $_placement['options']['ad_label'] : 'default';
$_position = ! empty( $_placement['options']['placement_position'] ) ? $_placement['options']['placement_position'] : 'default';
$_clearfix = ! empty( $_placement['options']['placement_clearfix'] );
include ADVADS_ABSPATH . 'admin/views/placements-ad-label.php';
$option_content = ob_get_clean();
Advanced_Ads_Admin_Options::render_option(
__( 'ad label', 'advanced-ads' ),
if ( ! empty( $placement_types[ $_placement['type'] ]['options']['show_position'] ) ) :
include ADVADS_ABSPATH . 'admin/views/placements-ad-label-position.php';
$option_content = ob_get_clean();
Advanced_Ads_Admin_Options::render_option(
__( 'Position', 'advanced-ads' ),
// Renders inline css option.
include ADVADS_ABSPATH . 'admin/views/placements-inline-css.php';
$option_content = ob_get_clean();
$inline_css = $_placement['options']['inline-css'] ?? '';
$placement_type = $_placement['type'] ?? '';
$show_option = ! ( 'custom_position' === $placement_type && empty( $inline_css ) );
Advanced_Ads_Admin_Options::render_option(
__( 'Inline CSS', 'advanced-ads' ),
// Show Pro features if Pro is not activated.
if ( ! defined( 'AAP_VERSION' ) ) {
// Minimum Content Length.
Advanced_Ads_Admin_Options::render_option(
'placement-content-minimum-length',
__( 'Minimum Content Length', 'advanced-ads' ),
__( 'Minimum length of content before automatically injected ads are allowed in them.', 'advanced-ads' )
Advanced_Ads_Admin_Options::render_option(
'placement-skip-paragraph',
__( 'Words Between Ads', 'advanced-ads' ),
__( 'A minimum amount of words between automatically injected ads.', 'advanced-ads' )
// show the conditions pitch on the `head` placement as well.
if ( ! defined( 'AAP_VERSION' ) ) {
// Display Conditions for placements.
Advanced_Ads_Admin_Options::render_option(
'placement-display-conditions',
__( 'Display Conditions', 'advanced-ads' ),
__( 'Use display conditions for placements.', 'advanced-ads' ) .
' ' . __( 'The free version provides conditions on the ad edit page.', 'advanced-ads' )
// Visitor Condition for placements.
Advanced_Ads_Admin_Options::render_option(
'placement-visitor-conditions',
__( 'Visitor Conditions', 'advanced-ads' ),
__( 'Use visitor conditions for placements.', 'advanced-ads' ) .
' ' . __( 'The free version provides conditions on the ad edit page.', 'advanced-ads' )
do_action( 'advanced-ads-placement-options-after-advanced', $_placement_slug, $_placement );
$advanced_options = ob_get_clean();
<tr id="single-placement-<?php echo esc_attr( $_placement_slug ); ?>"
class="advanced-ads-placement-row"
<?php self::render_order_data( $placement_types, $_placement ); ?>>
<td class="column-primary">
if ( $advanced_options ) {
'modal_slug' => $_placement_slug,
'modal_content' => $advanced_options,
/* translators: 1: "Options", 2: the name of a placement. */
'modal_title' => sprintf( '%1$s: %2$s', __( 'Options', 'advanced-ads' ), $_placement['name'] ),
'close_form' => 'advanced-ads-placements-form',
'close_action' => __( 'Close and save', 'advanced-ads' ),
<?php if ( $type_missing ) : // Type is not given. ?>
<p class="advads-notice-inline advads-error">
// Translators: %s is the name of a placement.
__( 'Placement type "%s" is missing and was reset to "default".<br/>Please check if the responsible add-on is activated.', 'advanced-ads' ),
<?php elseif ( isset( $_placement['type'] ) ) : ?>
<div class="advads-form-type">
<?php if ( isset( $placement_types[ $_placement['type'] ]['image'] ) ) : ?>
<img src="<?php echo esc_url( $placement_types[ $_placement['type'] ]['image'] ); ?>" alt="<?php echo esc_attr( $placement_types[ $_placement['type'] ]['title'] ); ?>"/>
<p class="advads-form-description">
<strong><?php echo esc_html( $placement_types[ $_placement['type'] ]['title'] ); ?></strong>
<div class="advads-table-name">
<a href="#modal-<?php echo esc_attr( $_placement_slug ); ?>" class="row-title" data-placement="<?php echo esc_attr( $_placement_slug ); ?>">
<?php echo esc_html( $_placement['name'] ); ?>
<?php echo esc_html( $placement_types[ $_placement['type'] ]['title'] ); ?>
<?php __( 'default', 'advanced-ads' ); ?>
<div class="row-actions">
<a href="#modal-<?php echo esc_attr( $_placement_slug ); ?>" class="" data-placement="<?php echo esc_attr( $_placement_slug ); ?>">
<?php esc_html_e( 'Edit', 'advanced-ads' ); ?>
<?php $last_key = array_search( end( $quick_actions ), $quick_actions, true ); ?>
<?php foreach ( $quick_actions as $quick_action => $action_link ) : ?>
<span class='<?php echo esc_attr( $quick_action ); ?> '>
'style' => 'cursor: pointer',
<?php if ( $quick_action !== $last_key ) : ?>
<span class="separator"> | </span>
<button type="button" class="toggle-row"><span class="screen-reader-text">Mehr Details anzeigen</span></button>
<input type="hidden" class="advads-placement-slug" value="<?php echo esc_attr( $_placement_slug ); ?>"/>
if ( 'default' === ( $_placement['type'] ?? '' ) ) {
<div class="advads-usage">
<h2><?php esc_html_e( 'shortcode', 'advanced-ads' ); ?></h2>
<input type="text" onclick="this.select();" value='[the_ad_placement id="<?php echo esc_attr( $_placement_slug ); ?>"]' readonly/>
<h2><?php esc_html_e( 'template (PHP)', 'advanced-ads' ); ?></h2>
<input type="text" onclick="this.select();" value="if( function_exists('the_ad_placement') ) { the_ad_placement('<?php echo esc_attr( $_placement_slug ); ?>'); }" readonly/>
'modal_slug' => $_placement_slug . '-usage',
'modal_content' => ob_get_clean(),
'modal_title' => __( 'Usage', 'advanced-ads' ),
<td class="advads-placements-table-options">
<?php do_action( 'advanced-ads-placement-options-before', $_placement_slug, $_placement ); ?>
Advanced_Ads_Admin_Options::render_option(
/* translators: 1: "Ad", 2: "Group". */ // phpcs:ignore Squiz.PHP.CommentedOutCode.Found
__( 'Ad', 'advanced-ads' ),
__( 'Group', 'advanced-ads' )
Advanced_Ads_Placements::get_items_for_placement_markup( $_placement_slug, $_placement )
switch ( $_placement['type'] ) :
$option_index = isset( $_placement['options']['index'] ) ? absint( max( 1, (int) $_placement['options']['index'] ) ) : 1;
$option_tag = $_placement['options']['tag'] ?? 'p';
// Automatically select the 'custom' option.
if ( ! empty( $_COOKIE['advads_frontend_picker'] ) ) {
$option_tag = ( $_COOKIE['advads_frontend_picker'] === $_placement_slug ) ? 'custom' : $option_tag;
$option_xpath = isset( $_placement['options']['xpath'] ) ? stripslashes( $_placement['options']['xpath'] ) : '';
'after' => __( 'after', 'advanced-ads' ),
'before' => __( 'before', 'advanced-ads' ),
include ADVADS_ABSPATH . 'admin/views/placements-content-index.php';
if ( ! defined( 'AAP_VERSION' ) ) {
include ADVADS_ABSPATH . 'admin/views/upgrades/repeat-the-position.php';
do_action( 'advanced-ads-placement-post-content-position', $_placement_slug, $_placement );
$option_content = ob_get_clean();
Advanced_Ads_Admin_Options::render_option(
'placement-content-injection-index',
__( 'position', 'advanced-ads' ),
if ( ! extension_loaded( 'dom' ) ) :
<p><span class="advads-notice-inline advads-error"><?php esc_html_e( 'Important Notice', 'advanced-ads' ); ?>: </span>
// translators: %s is a list of PHP extensions.
esc_html__( 'Missing PHP extensions could cause issues. Please ask your hosting provider to enable them: %s', 'advanced-ads' ),
do_action( 'advanced-ads-placement-options-after', $_placement_slug, $_placement );
// Information after options.
if ( isset( $_placement['type'] ) && 'header' === $_placement['type'] ) :
// translators: %s is a URL.
__( 'Tutorial: <a href="%s" target="_blank">How to place visible ads in the header of your website</a>.', 'advanced-ads' ),
'https://wpadvancedads.com/place-ads-in-website-header/?utm_source=advanced-ads&utm_medium=link&utm_campaign=header-ad-tutorial'
<?php if ( $advanced_options ) : ?>
<div class="advads-placements-show-options">
<a href="#modal-<?php echo esc_attr( $_placement_slug ); ?>" data-placement="<?php echo esc_attr( $_placement_slug ); ?>"><?php esc_html_e( 'show all options', 'advanced-ads' ); ?></a>
<td class="advads-placement-conditions">
<?php if ( ! empty( $_placement['options']['placement_conditions']['display'] ) ) : ?>
<h4><?php echo esc_html__( 'Display Conditions', 'advanced-ads' ); ?></h4>
<?php foreach ( $_placement['options']['placement_conditions']['display'] as $condition ) : ?>
<?php if ( array_key_exists( $condition['type'], (array) $display_conditions->conditions ) ) : ?>
<?php echo esc_html( $display_conditions->conditions[ $condition['type'] ]['label'] ); ?>
<?php if ( ! empty( $_placement['options']['placement_conditions']['visitors'] ) ) : ?>
<h4><?php echo esc_html__( 'Visitor Conditions', 'advanced-ads' ); ?></h4>
<?php foreach ( $_placement['options']['placement_conditions']['visitors'] as $condition ) : ?>
<?php if ( array_key_exists( $condition['type'], $visitor_conditions->conditions ) ) : ?>
<?php echo esc_html( $visitor_conditions->conditions[ $condition['type'] ]['label'] ); ?>
<?php if ( $advanced_options ) : ?>
<a href="#modal-<?php echo esc_attr( $_placement_slug ); ?>" data-placement="<?php echo esc_attr( $_placement_slug ); ?>" class="advads-mobile-hidden"><?php esc_html_e( 'edit conditions', 'advanced-ads' ); ?></a>
<?php do_action( 'advanced-ads-placements-list-column', $_placement_slug, $_placement ); ?>
id="advads-placements-item-delete-<?php echo esc_attr( $_placement_slug ); ?>"
class="advads-placements-item-delete"
name="advads[placements][<?php echo esc_attr( $_placement_slug ); ?>][delete]"
<label for="advads-placements-item-delete-<?php echo esc_attr( $_placement_slug ); ?>"><?php echo esc_html_x( 'delete', 'checkbox to remove placement', 'advanced-ads' ); ?></label>
<div class="tablenav bottom">
<input type="submit" id="advads-save-placements-button" class="button button-primary" value="<?php esc_html_e( 'Save Placements', 'advanced-ads' ); ?>"/>
<?php wp_nonce_field( 'advads-placement', 'advads_placement', true ); ?>
<a href="#modal-placement-new" class="button" title="<?php esc_html_e( 'Create a new placement', 'advanced-ads' ); ?>"><?php esc_html_e( 'New Placement', 'advanced-ads' ); ?></a>
<?php do_action( 'advanced-ads-placements-list-buttons', $placements ); ?>
<input type="hidden" name="advads-last-edited-placement" id="advads-last-edited-placement" value="0"/>
include ADVADS_ABSPATH . 'admin/views/frontend-picker-script.php';
do_action( 'advanced-ads-placements-list-after', $placements );