CODEX
Shortcodes, Hooks & Functions
Referencia completa de FOX – WooCommerce Currency Switcher
- SC [[woocs]] El shortcode principal del conmutador de moneda: coloca el menú desplegable, las banderas o la lista de enlaces en cualquier página, widget o plantilla. Los atributos controlan la vista, el estilo y qué monedas aparecen. →
- SC [[woocs_converter]] Añade un conversor de moneda de WooCommerce a cualquier página — una pequeña calculadora AJAX que convierte un importe entre dos monedas sin modificar los precios de tus productos. Atributos: exclude, precision. →
- SC [[woocs_geo_hello]] Shortcode de diagnóstico para Geo IP. Colócalo en una página o en un widget para comprobar si la geolocalización está funcionando, qué país se detectó y a qué moneda se resolvieron las reglas. →
- SC [[woocs_get_sign_rate]] Imprime el tipo de cambio actual de una moneda frente a la moneda base de la tienda como texto plano, en cualquier parte de tu contenido. →
- SC [[woocs_price]] Muestra el precio de un solo producto por su ID, en la moneda que el visitante haya seleccionado — para páginas de aterrizaje y textos escritos fuera del bucle de WooCommerce. →
- SC [[woocs_rates]] Muestra los tipos de cambio de tu tienda a los clientes como una tabla. Los atributos te permiten excluir monedas y cambiar el diseño. →
- SC [[woocs_show_current_currency]] Imprime la moneda en la que el visitante está navegando actualmente, con texto opcional antes y después. →
- SC [[woocs_show_custom_price]] Hace que cualquier importe en tu texto promocional sea intercambiable. Escribe el valor en la moneda base y seguirá la moneda que elija el visitante. →
- do_action woocs_before_settings_update Acción que se ejecuta en wp-admin justo después de la verificación del nonce y justo antes de que FOX guarde sus opciones desde el formulario enviado. Úsalo para guardar campos adicionales añadidos a la página de ajustes del plugin. →
- do_action woocs_exchange_value Punto de entrada al plugin: pasa cualquier cantidad en la moneda base a través de esta acción y recíbela de vuelta en la moneda que el visitante haya seleccionado. La forma habitual de hacer que tus propios números sean intercambiables. →
- do_action woocs_force_pay_bygeoip_rules Se ejecuta en la página de pago cuando "Pago por reglas GeoIP" está activado, para que puedas sobrescribir en qué moneda se fuerza el pedido para un país determinado. →
- do_action woocs_freemius_loaded Acción que se ejecuta una vez que el SDK de Freemius ha sido inicializado, el punto seguro en el que la API de licencias está disponible. →
- do_action woocs_sheduler_rates_updated Se ejecuta después de que finalice la actualización programada de tasas de cambio. Úsalo para registrar el historial de tasas, notificar a un sistema externo o recalcular algo que dependa de las nuevas tasas. Desde v.2.4.5 / 1.4.5. →
- do_action woocs_update_rates_wpcron El evento programado al que FOX adjunta su actualización de tasas. Ejecutarlo realiza una actualización completa de las tasas de cambio de inmediato, que es cómo impulsar las actualizaciones desde un cron real del servidor en lugar del cron de WordPress. →
- apply_filters woocs_add_aggregator_processor Registra el código que obtiene las tasas de tu propia fuente de tasas de cambio. Funciona en conjunto con woocs_announce_aggregator. Desde v.2.3.1 / 1.3.1. →
- apply_filters woocs_add_custom_rate Cambia una tasa de moneda sobre la marcha, o reemplaza la obtención de tasas por completo con tu propia lógica. Desde v.2.3.1 / 1.3.1. →
- apply_filters woocs_announce_aggregator Añade tu propio agregador a la lista que el propietario de la tienda puede elegir en los ajustes. Funciona en conjunto con woocs_add_aggregator_processor. Desde v.2.3.1 / 1.3.1. →
- apply_filters woocs_back_convert_price Punto de entrada al plugin: convierte una cantidad de la moneda seleccionada actualmente de vuelta a la moneda base de la tienda. La solución para reglas de terceros que comparan totales convertidos contra umbrales de la moneda base. →
- apply_filters woocs_bank_polski_table Selecciona qué tabla de tasas del agregador Narodowy Bank Polski leer. Por defecto es la tabla A. Desde v.2.3.1 / 1.3.1. →
- apply_filters woocs_capability_allows_change_order Permite a usuarios seleccionados editar los datos de moneda del pedido sin otorgarles la capacidad completa manage_options. →
- apply_filters woocs_convert_price Punto de entrada al plugin: convierte una cantidad de la moneda base a la actualmente seleccionada. La forma estándar para que un plugin de terceros tome conciencia de la moneda sin una dependencia directa de FOX. →
- apply_filters woocs_convert_price_wcdp Punto de entrada al plugin para motores de descuento: convierte una cantidad de la moneda base a la actual, pero solo cuando el tercer argumento es discount__amount. →
- apply_filters woocs_cookie Filtro que cambia el nombre de la cookie de sesión de FOX. Renombrarla evita que las cachés que tratan cualquier cookie con prefijo wp_ como un usuario conectado omitan la caché. Debe registrarse desde mu-plugins. →
- apply_filters woocs_currency_data_manipulation Filtra toda la tabla de monedas antes de que el plugin la use — tasas, símbolos, decimales y posiciones — para que los datos de moneda puedan venir de cualquier lugar que desees. →
- apply_filters woocs_currency_manipulation_before_show Filtra la lista de monedas justo antes de que se dibuje el conmutador, para que puedas ocultar, reordenar o renombrar monedas por página, por usuario o según cualquier regla. →
- apply_filters woocs_currency_symbol_on_order Filtro que le indica a FOX que deje el símbolo de moneda sin tocar en las páginas de pedido recibido y de cuenta, para que un recibo conserve el símbolo de la moneda en la que se pagó el pedido. Por defecto false. →
- apply_filters woocs_currency_symbols Añade o reemplaza símbolos de moneda. El hook que usar para un símbolo de moneda personalizado en WooCommerce, o para una moneda que no tiene ningún glifo estándar. →
- apply_filters woocs_currname_in_option Cambia el texto de una línea de moneda dentro del desplegable del conmutador, cuando el código más símbolo por defecto no es lo que tus clientes deberían leer. →
- apply_filters woocs_cut_cart_price_format Elimina el formato de precio personalizado en las páginas de carrito y finalizar compra, donde un formato decorado a veces entra en conflicto con otros plugins. →
- apply_filters woocs_disable_backend_refund_calculation Desactiva la conversión de moneda mientras se procesa un reembolso en wp-admin, para tiendas que almacenan reembolsos en la moneda base por política. →
- apply_filters woocs_drop_down_view Cambia la apariencia del desplegable del conmutador de moneda sobre la marcha, para que diferentes páginas o grupos de usuarios puedan tener diferentes diseños de conmutador. →
- apply_filters woocs_fixed_price_user_rope Filtro que pasa el precio resuelto por la función de precios basados en el rol de usuario, junto con el ID del producto, el tipo de precio y los roles de usuario. Nota el error tipográfico en el nombre del hook: rope, no role. →
- apply_filters woocs_fixed_raw_woocommerce_price Filtra el precio bruto cuando están en juego precios fijos por moneda. El punto de enganche habitual para hacer que un plugin de precios de terceros respete los precios fijos. →
- apply_filters woocs_form_method Cambia el método del formulario del conmutador de POST a GET, que algunos sistemas de caché y constructores de páginas necesitan. Desde v.2.2.0 / 1.2.0. →
- apply_filters woocs_geobone_ip Filtro que controla el comportamiento de solo primera visita de las reglas Geo IP. Devolver false desactiva la bandera que hace que una regla geográfica se aplique una vez por visitante. Por defecto true. →
- apply_filters woocs_get_approximate_amount_text Cambia el texto alrededor del monto aproximado que se muestra en las páginas de carrito y finalizar compra cuando la opción "Mostrar monto aprox." está activada. →
- apply_filters woocs_init_compatibility_woo_subscriptions Activa la compatibilidad con WooCommerce Subscriptions, para que los montos de renovación mantengan la moneda en la que se creó la suscripción. →
- apply_filters woocs_order_formatted_prices Controla el formato de precios en las páginas de pedido y agradecimiento. Devuelve false para dejar el formato de WooCommerce completamente intacto. →
- apply_filters woocs_precision_on_calc Aumenta la precisión del cálculo interno. Necesario cuando los precios unitarios son muy pequeños: con cuatro decimales, un artículo de 0.000423 se redondea a nada. →
- apply_filters woocs_price_decimal_sep Establece el separador decimal por moneda o según cualquier otra regla, para que cada mercado lea los precios como espera. →
- apply_filters woocs_price_format Filtra toda la cadena de formato de precios de WooCommerce, para tener control total sobre dónde se coloca el símbolo y qué rodea al número. →
- apply_filters woocs_price_html Filtra el marcado final del precio de un producto. El hook para añadir un símbolo de moneda personalizado, una nota o cualquier marcado propio a cada precio de la tienda. →
- apply_filters woocs_price_html_tail Añade texto o marcado después del precio de un producto en las páginas de tienda y categorías: un monto aproximado, una nota de impuestos, una indicación por unidad. →
- apply_filters woocs_price_shortcode Filtra el precio producido por el shortcode [woocs_price], para que un precio impreso fuera del bucle de producto pueda seguir su propia regla. →
- apply_filters woocs_price_thousand_sep Establece el separador de miles por moneda o según cualquier otra regla, para que 1,299.00 y 1 299,00 puedan convivir en la misma tienda. →
- apply_filters woocs_product_fixed_price_data_simple_types Declara a qué tipos de producto se aplican los precios fijos por moneda, para que un tipo de producto personalizado pueda participar. →
- apply_filters woocs_raw_woocommerce_price Filtra el precio numérico sin formato antes de formatearlo. Aquí es donde residen las reglas de redondeo de precios: a 50 centavos, a 99 centavos, a una unidad completa. →
- apply_filters woocs_redraw_cart Desactiva el redibujado del mini-carrito después de un cambio de moneda, lo que resuelve conflictos con temas y scripts que reconstruyen el carrito por sí mismos. →
- apply_filters woocs_show_side_swither Filtro con la última palabra sobre si el conmutador lateral flotante se renderiza en la página actual, aplicado después de la configuración y exclusiones del plugin. Nota el error tipográfico en el nombre del hook: swither. →
- apply_filters woocs_side_switcher_data Filtro que pasa la matriz completa de configuración del conmutador lateral — skin, lado, desplazamiento, colores y plantillas de campo — antes de que se renderice el panel. →
- apply_filters woocs_woocommerce_available_variation Filtro que pasa la matriz de datos de una variación individual después de que FOX haya convertido sus precios, incluyendo price_html, en su camino hacia el frontend como JSON. →
- apply_filters woocs_woocommerce_variation_prices Filtra el rango de precios de un producto variable, para que la línea de «desde-hasta» en un producto variable siga tu propia lógica de moneda. →
- fn() $WOOCS->back_convert() Convierte un monto de la moneda actualmente seleccionada de vuelta a la moneda base de la tienda — la solución para código de terceros que compara un total convertido con un umbral de moneda base. →
- fn() $WOOCS->convert_from_to_currency($value, $from_currency, $to_currency) Convierte un monto entre dos monedas directamente, sin pasar por la moneda base. Disponible desde v.2.4.0 / v.1.4.0. →
- fn() $WOOCS->current_currency La propiedad que contiene la moneda en la que el visitante está navegando en este momento. El punto de partida para casi cualquier lógica de moneda personalizada. →
- fn() $WOOCS->default_currency La propiedad que contiene la moneda base de la tienda, la que WooCommerce tiene configurada y contra la que se calcula cada tasa. →
- fn() $WOOCS->get_checkout_page_id() Devuelve el ID de la página de pago, para que tu propio código pueda saber de forma fiable si la solicitud actual es el pago. →
- fn() $WOOCS->get_currencies($suppress_filters = false) Devuelve todas las monedas configuradas en los ajustes del plugin, con su tasa, símbolo, decimales y posición — la tabla completa de monedas como un array. →
- fn() $WOOCS->get_currency_by_country() Devuelve la moneda que las reglas Geo IP resuelven para el país del visitante. Funciona solo mientras la opción Geo IP esté activada. →
- fn() $WOOCS->get_currency_price_num_decimals() Devuelve cuántos decimales está configurada una moneda determinada para mostrar, para que tu salida de precio coincida con el resto de la tienda. →
- fn() $WOOCS->get_geo_rules() Devuelve el array de reglas Geo IP — qué país se asigna a qué moneda — para leerlo o actuar sobre él desde tu propio código. →
- fn() $WOOCS->get_welcome_currency() Devuelve la moneda de bienvenida: la que ve un visitante por primera vez antes de hacer su propia elección. →
- fn() $WOOCS->is_multiple_allowed La propiedad que te indica si el pago con múltiples monedas está activado, es decir, si los clientes pueden pagar en la moneda que seleccionaron. →
- fn() $WOOCS->is_use_geo_rules() Devuelve verdadero cuando la opción Geo IP está activada, para que tu código pueda bifurcarse según si las reglas de país están en juego. →
- fn() $WOOCS->make_rates_auto_update() Ejecuta una actualización completa de las tasas de cambio inmediatamente, la misma que realiza el cron integrado. Úsalo para impulsar actualizaciones desde un cron real del servidor. →
- fn() $WOOCS->reset_currency() Restablece al visitante a la moneda base de la tienda — útil cuando un proceso de terceros debe ejecutarse en contexto de moneda base. →
- fn() $WOOCS->set_currency() Establece la moneda para el visitante actual desde tu propio código, cualquier lógica que necesites. Disponible desde v.2.1.8 / v.1.1.8. →
- fn() $WOOCS->storage->get_val() Lee un valor de la capa de almacenamiento de FOX — la moneda seleccionada entre otras — cualquiera que sea el backend de almacenamiento configurado en la tienda. →
- fn() $WOOCS->storage->set_val() Escribe un valor en la capa de almacenamiento de FOX, para que el código personalizado pueda mantener el estado junto al plugin en lugar de inventar su propia sesión. →
- fn() $WOOCS->woocs_exchange_value() Convierte un monto de la moneda base de la tienda a la moneda que seleccionó el visitante — la llamada de conversión cotidiana. →
- fn() REST API Endpoints de la API REST para leer datos de moneda y precios de productos de forma programática, para frontends headless, aplicaciones móviles e integraciones externas. →