# dynamic_sidebar_params

URL: https://chugunov.pro/api-wordpress/filters/dynamic_sidebar_params/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 2.5.0.

## Сигнатура

```php
apply_filters( 'dynamic_sidebar_params', array $params )
```

## Описание

Примечание: фильтр применяется как в публичной части сайта, так и в административной, включая сайдбар «Неактивные виджеты» на экране «Виджеты».
См. alsoregister_sidebar()

## Параметры

- `$params` `array` — обязательный. - `args` array An array of widget display arguments.
  
  - `name` string Name of the sidebar the widget is assigned to.
  
  - `id` string ID of the sidebar the widget is assigned to.
  
  - `description` string The sidebar description.
  
  - `class` string CSS class applied to the sidebar container.
  
  - `before_widget` string HTML markup to prepend to each widget in the sidebar.
  
  - `after_widget` string HTML markup to append to each widget in the sidebar.
  
  - `before_title` string HTML markup to prepend to the widget title when displayed.
  
  - `after_title` string HTML markup to append to the widget title when displayed.
  
  - `widget_id` string ID of the widget.
  
  - `widget_name` string Name of the widget.
  
  - `widget_args` array An array of multi-widget arguments.
  
  - `number` int Number increment used for multiples of the same widget.
  
  [Source](#source)
  
  ```
  $params = apply_filters( 'dynamic_sidebar_params', $params );
  ```
  
  [View all references](https://developer.wordpress.org/reference/files/wp-includes/widgets.php/) [View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/widgets.php#L813) [View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/widgets.php#L813-L813)
  
  [Related](#related) Used by | Description |
  [wp_render_widget()](https://developer.wordpress.org/reference/functions/wp_render_widget/)`wp-includes/widgets.php` | Calls the render callback of a widget and returns the output.
  |
  [dynamic_sidebar()](https://developer.wordpress.org/reference/functions/dynamic_sidebar/)`wp-includes/widgets.php` | Displays dynamic sidebar.
  |
  
  [Changelog](#changelog) Version | Description |
  [2.5.0](https://developer.wordpress.org/reference/since/2.5.0/) | Introduced. |
  
  [User Contributed Notes](#user-contributed-notes)
  -
  
  [Skip to note 2 content](#comment-content-4295)
  
  [Razon Komar Pal](https://profiles.wordpress.org/raazon/)
  [
  
  6 years ago
  ](https://developer.wordpress.org/reference/hooks/dynamic_sidebar_params/#comment-4295)
  
  [You must log in to vote on the helpfulness of this note ](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdynamic_sidebar_params%2F%23comment-4295)Vote results for this note: 1 [You must log in to vote on the helpfulness of this note ](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdynamic_sidebar_params%2F%23comment-4295)
  
  Firstly we create a custom widget field end of the each widgets control form.
  
  ```
  if ( ! function_exists( 'wpdocs_display_custom_field_in_widget_form' ) ) {
  
  add_action( 'in_widget_form', 'wpdocs_display_custom_field_in_widget_form', 10, 3 );
  
  /**
  * Append custom field end of the widgets control form
  * Fires at the end of the widget control form.
  */
  function wpdocs_display_custom_field_in_widget_form( $widget, $return, $instance ) {
  $column = isset( $instance['column'] ) ? $instance['column'] : '';
  
  ob_start(); 
  ?>

## Фильтруемое значение

- `args` array An array of widget display arguments.

- `name` string Name of the sidebar the widget is assigned to.

- `id` string ID of the sidebar the widget is assigned to.

- `description` string The sidebar description.

- `class` string CSS class applied to the sidebar container.

- `before_widget` string HTML markup to prepend to each widget in the sidebar.

- `after_widget` string HTML markup to append to each widget in the sidebar.

- `before_title` string HTML markup to prepend to the widget title when displayed.

- `after_title` string HTML markup to append to the widget title when displayed.

- `widget_id` string ID of the widget.

- `widget_name` string Name of the widget.

- `widget_args` array An array of multi-widget arguments.

- `number` int Number increment used for multiples of the same widget.

[Source](#source)

```
$params = apply_filters( 'dynamic_sidebar_params', $params );
```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/widgets.php/) [View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/widgets.php#L813) [View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/widgets.php#L813-L813)

[Related](#related) Used by | Description |
[wp_render_widget()](https://developer.wordpress.org/reference/functions/wp_render_widget/)`wp-includes/widgets.php` | Calls the render callback of a widget and returns the output.
|
[dynamic_sidebar()](https://developer.wordpress.org/reference/functions/dynamic_sidebar/)`wp-includes/widgets.php` | Displays dynamic sidebar.
|

[Changelog](#changelog) Version | Description |
[2.5.0](https://developer.wordpress.org/reference/since/2.5.0/) | Introduced. |

[User Contributed Notes](#user-contributed-notes)
-

[Skip to note 2 content](#comment-content-4295)

[Razon Komar Pal](https://profiles.wordpress.org/raazon/)
[

6 years ago
](https://developer.wordpress.org/reference/hooks/dynamic_sidebar_params/#comment-4295)

[You must log in to vote on the helpfulness of this note ](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdynamic_sidebar_params%2F%23comment-4295)Vote results for this note: 1 [You must log in to vote on the helpfulness of this note ](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fdynamic_sidebar_params%2F%23comment-4295)

Firstly we create a custom widget field end of the each widgets control form.

```
if ( ! function_exists( 'wpdocs_display_custom_field_in_widget_form' ) ) {

add_action( 'in_widget_form', 'wpdocs_display_custom_field_in_widget_form', 10, 3 );

/**
* Append custom field end of the widgets control form
* Fires at the end of the widget control form.
*/
function wpdocs_display_custom_field_in_widget_form( $widget, $return, $instance ) {
$column = isset( $instance['column'] ) ? $instance['column'] : '';

ob_start(); 
?>

## Исходный код

Файл: `wp-includes/widgets.php:813`

```php
$params = apply_filters( 'dynamic_sidebar_params', $params );
```

## История изменений

- 2.5.0 — Introduced.

## Связанные

Используется в: [`wp_render_widget`](https://chugunov.pro/api-wordpress/functions/wp_render_widget/), [`dynamic_sidebar`](https://chugunov.pro/api-wordpress/functions/dynamic_sidebar/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/dynamic_sidebar_params/
