WOLF

WPBE_SETTINGS::get_fields() combina la lista estática de campos de data/fields.php con una columna por cada taxonomía registrada para el tipo de contenido actual, y luego aplica el orden de columnas y los títulos guardados del usuario. Los campos nuevos que aparecen más tarde (una taxonomía nueva, una clave meta nueva) se añaden al final en lugar de perderse.

Las definiciones de campo llevan allow_post_types y prohibit_post_types. wrap_field_val() devuelve una celda 'restricted' cuando un campo no se aplica, por ejemplo los campos de estado y de comentarios para los adjuntos, el tipo MIME solo para los adjuntos, sticky solo para las entradas. Los adjuntos se consultan con el estado adicional 'inherit'.

La tabla se configura con serverSide: true y llama a wpbe_get_posts con los parámetros de paginación de DataTables. WPBE_POSTS::gets() convierte start/length en paged/posts_per_page y cambia a la ordenación meta_value_num cuando la columna de ordenación es un campo meta numérico o de fecha.

Las filas por página están limitadas a 100 con el comentario del código 'to avoid 500 error on weak servers'. La versión gratuita lo limita a 10.

init() ejecuta primero una comprobación de rol y después is_should_init(), que devuelve true solo para page=wpbe o una acción AJAX cuyo nombre contenga 'wpbe_'. En otras pantallas de administración solo se registran la entrada de menú, el botón de la barra de administración y los avisos.

Las extensiones siguen una convención de nombres (ext/<slug>/<slug>.php, clase WPBE_<SLUG>) y reciben el almacenamiento, los ajustes y el modelo de entradas mediante init_vars(). El mismo cargador recoge también extensiones de terceros desde wp-content/wpbe_ext.

Los ajustes residen en la opción wpbe_options_<user_id>. Cuando el interruptor 'separate settings' está activado, el tipo de contenido se añade a la clave, y la lista de campos meta registrados se divide por tipo de contenido de la misma manera. El tipo de contenido activo se recuerda por usuario en el almacenamiento del plugin.

El interruptor está desactivado en la versión gratuita.

Cuando SitePress está presente, el filtro wpbe_current_language devuelve ICL_LANGUAGE_CODE, gets() llama a $sitepress->switch_lang() antes de construir WP_Query, y la opción de entradas sticky se lee y se escribe bajo sticky_posts_<lang>.

wpbe_bulk_posts_count guarda el formulario masivo bajo 'wpbe_bulk_<key>' (16 caracteres aleatorios generados en el navegador) y devuelve los ID que coinciden con el filtro actual, usando fields=ids y no_found_rows. El navegador divide esa lista en lotes de 50 y los envía uno tras otro a wpbe_bulk_posts, actualizando una barra de progreso y un indicador en la barra de administración. Cancelar aborta el XHR pendiente; wpbe_bulk_finish devuelve el total contado.

La eliminación masiva usa el mismo patrón con lotes de 10 y wp_trash_post(), de modo que las entradas eliminadas siguen siendo recuperables desde la papelera.

Tras una ejecución, el navegador vuelve a dibujar solo las filas afectadas cuando se cambiaron cuatro entradas o menos, y vuelve a dibujar la página actual en caso contrario.

__process_text_data() lee el valor actual de cada entrada y aplica el comportamiento elegido. Los valores pueden contener {TITLE}, {ID}, {MENU_ORDER} y {meta:key}, resueltos por entrada, y macros de mayúsculas y minúsculas como {DO_STRING_UP} o {DO_STRING_TITLE} que usan las funciones mb_*, de modo que los títulos no latinos se tratan correctamente.

__process_number_data() admite aumentar o disminuir por valor o porcentaje y, opcionalmente, combina el resultado con otro campo meta de la misma entrada (+, -, *, /, con la división por cero sustituida por 1) y con un número aleatorio de un rango escalado por un factor decimal.

El redondeo de la fracción a pasos de .05 o .10, o a una terminación como .99, ocurre en update_page_field() con el número de decimales configurado; los céntimos se convierten mediante un paso entero porque el módulo en coma flotante da resultados erróneos.

WordPress espera ID para las taxonomías jerárquicas y nombres o slugs para las de tipo etiqueta. El trabajador masivo comprueba is_taxonomy_hierarchical(); para las taxonomías planas convierte cada ID en un slug, y para 'replace' escribe el primer término con append=false y el resto con append=true. 'Remove' usa wp_remove_object_terms().

El hook del historial se dispara manualmente antes de los cambios de términos, porque esta vía evita update_page_field().

El paso de recuento escribe la fila de cabecera; cada lote añade filas con fputcsv() sobre un archivo abierto en modo a+. El código señala que WP_Filesystem no tiene escritura línea a línea, y por eso aquí se usan funciones de archivo sin procesar.

La exportación XML construye un documento RSS con los espacios de nombres WXR 1.2 (wp:, content:, excerpt:), los términos como <category domain nicename> y el meta como wp:postmeta con CDATA, de modo que el archivo sigue el formato del exportador de WordPress. Los nombres de archivo llevan la fecha y el minuto de la exportación, y los archivos de más de dos días se eliminan mediante una comprobación limitada por un transient.

El navegador genera wpbe_filter_current_key cuando se aplica un filtro y la envía con cada petición; el comentario del código fuente dice que esto permite la edición masiva por filtro en distintas pestañas. wpbe_apply_query_filter_data() lee el filtro almacenado y se aplica dentro de WPBE_POSTS::gets(), de modo que la lista de ID de la edición masiva la construye el mismo código que la tabla visible.

Para el operador AND, cada término seleccionado se convierte en su propia cláusula unida por la relación externa AND, que es la solución alternativa a la que alude el comentario del código. Los demás operadores (IN, NOT IN) pasan la lista de términos tal cual. include_children lo controla un filtro en lugar del valor por defecto de WordPress.

El comentario del código expone el caso: con DECIMAL sin precisión, una búsqueda de 100 a 150 devolvía también 99.xx. El filtro usa DECIMAL(30,20), cambia a >= cuando solo se establece 'from' y a = cuando ambos límites son iguales. El meta de fecha pasa primero por normalize_calendar_date().

Las entradas creadas antes de que se introdujera una clave meta no tienen ninguna fila, así que una comprobación de igualdad por sí sola no las encuentra. El comportamiento 'empty' emite un meta_query anidado con relación OR.

posts_txt_where() pasa la entrada a minúsculas, la divide por ^ y construye condiciones LOWER(column) REGEXP / NOT REGEXP con los modos begin, end, exact y not. Cada valor se enlaza mediante $wpdb->prepare() y la columna debe estar en una lista de permitidos de cinco columnas de wp_posts.

Los elementos separados por comas se toman como ID; un elemento con un guion se expande al rango completo sin importar el orden. Los rangos de fechas y de números en columnas de wp_posts (menu_order, post_parent, fechas de la entrada) pasan por un filtro posts_where separado con una lista de permitidos de columnas.

write() está enganchada a wpbe_before_update_page_field, que update_page_field() dispara antes de cada escritura; la vía masiva de taxonomías, que escribe los términos directamente, la dispara a mano. Los valores de taxonomía se guardan como una lista JSON de ID de término, el meta de arrays como JSON (con JSON_HEX_QUOT y JSON_HEX_TAG para el editor de meta serializado) y los escalares tal cual. Cada fila tiene user_id y post_type, y la clave masiva cuando forma parte de una ejecución.

start_bulk() inserta la fila de cabecera con la lista de campos editados como JSON; cada lote suma su tamaño mediante UPDATE posts_count = posts_count + %d; finish_bulk() marca la ejecución como completada. Una ejecución cancelada por el usuario conserva el estado por defecto 'terminated', de modo que el listado la muestra como parcial. Ambas tablas se crean con dbDelta y el conjunto de caracteres del sitio, se indexan por bulk_key y user_id y se eliminan al desinstalar.

El navegador pide el número de filas de la clave masiva y luego llama repetidamente a wpbe_history_revert_bulk_portion con límite 10 y una barra de progreso. Cada fila revertida se elimina, así que la siguiente porción recoge las restantes; la fila de cabecera se elimina cuando el contador alcanza el total.

revert() desengancha el escritor del historial, decodifica el valor almacenado según el tipo de campo (listas de ID de término, arrays meta JSON) y lo escribe de vuelta mediante el mismo update_page_field() usado para las ediciones, de modo que save_post y edit_post se disparan en una reversión igual que en una edición.

get_history() lee las filas individuales y las cabeceras masivas del usuario y el tipo de contenido actuales, las combina y las ordena por tiempo, las más recientes primero, de modo que una lista muestra ambos tipos de cambio.

La versión gratuita muestra las dos entradas más recientes y poda las filas individuales y cabeceras masivas más antiguas cuando se abre la lista.

wpbe_meta_get_keys devuelve las claves meta de un ID de entrada introducido por el administrador. Una clave registrada se inyecta mediante los hooks wpbe_extend_fields, wpbe_filter_* y wpbe_bulk_*, de modo que aparece a la vez en la tabla, en el panel de filtros y en el panel de edición masiva. Las claves se recortan de espacios pero no se pasan a minúsculas, porque claves como _woocs_sale_price_USD distinguen entre mayúsculas y minúsculas.

La versión gratuita usa solo los dos primeros campos meta registrados.

El elemento emergente envía keys[]/values[] para arrays planos y anidados, y keys2[][]/values2[][] para listas de objetos. __process_jsoned_meta_data() reconstruye el array PHP, decodifica los valores que son JSON válido y recurre al valor sin procesar para las cadenas simples. Luego update_post_meta() lo almacena serializado como espera WordPress. La misma vía la usa el trabajador masivo.

over_switcher_swicher_to_val() y over_switcher_val_to_swicher() leen una cadena de ajustes como 'dist:yes,stest:true' y convierten en ambos sentidos, de modo que la interfaz del interruptor funciona con valores escritos por otros plugins.

El elemento emergente de la galería envía un formulario codificado en URL; el manejador detecta la codificación, lo analiza con parse_str(), lo sanea y guarda los ID como una cadena separada por comas. El trabajador masivo acepta el mismo formato.

Opción 'Use gutenberg'. Para los tipos de contenido que usan el editor de bloques, el elemento emergente carga post.php con wpbe_popup_editor=1; wp_editor_compatibility() oculta los controles de publicación y de la barra lateral en ese marco y expone una función que devuelve wp.data.select('core/editor').getEditedPostContent(). La página padre lo lee y lo guarda mediante la actualización normal de campos.

can_manage_data() permite a los administradores, a los editores y a los roles añadidos mediante el filtro wpbe_author_area_roles. Si falla, init() retorna antes de que se carguen las extensiones, de modo que las acciones AJAX no existen para ese usuario. Las actualizaciones de campos, la edición y eliminación masivas, el panel de herramientas (crear, duplicar, eliminar, términos), los ajustes meta, el formulario de opciones, la lista del historial y las reversiones individuales comprueban además un nonce.

Para los roles que no son administrador, get_fields() descarta las columnas ocultas, de modo que no se ofrecen en la tabla ni en el panel de edición masiva; update_page_field() comprueba is_current_user_can_edit_field() y devuelve 'forbidden' para un campo oculto; filter_post_types() acota el selector de tipos de contenido, y el constructor de ajustes traslada al usuario a un tipo de contenido permitido. En la versión gratuita las casillas de visibilidad se muestran desactivadas.

Para los roles añadidos mediante el filtro wpbe_author_area_roles, WPBE_AUTHOR_AREA añade 'author' => ID del usuario actual mediante el filtro de consulta que usan la tabla, la lista de ID de la edición masiva y la exportación, de modo que estas listas muestran solo las entradas del propio usuario. Su callback wpbe_user_can_edit bloquea post_author para esos roles.

Los filtros de texto y de rango aceptan solo columnas de wp_posts de la lista y enlazan los valores mediante prepare(). Las consultas del historial enlazan usuario, tipo de contenido y clave masiva, y construyen listas NOT IN a partir de marcadores de posición de array_fill().

La duplicación copia los términos por slug y todo postmeta excepto _wp_old_slug en una sola sentencia INSERT ... SELECT %d, %s, %s UNION ALL, con cada fila construida con prepare(), y después deja la copia como borrador.

wpbe_update_page_field() sanea los arrays de forma recursiva con wp_kses y la lista de permitidos de post. Para los campos de contenido, extracto y texto enriquecido añade iframe con un conjunto fijo de atributos para que los embeds de vídeo sobrevivan. Un filtro puede cambiar a sanitize_text_field() para sitios más estrictos.