Complemento de sugerencias automáticas de what3words

Descripción

Este complemento le permite agregar fácilmente la búsqueda, captura y validación de una dirección de what3words a un formulario en su sitio con WordPress.

Al devolver sugerencias basadas en direcciones de 3 palabras completas o parciales, la función AutoSuggest ayuda a los usuarios con los siguientes tipos de errores de entrada:
– errores tipográficos
– errores de ortografía
– palabras mal recordadas (por ejemplo, singular o plural) o palabras en el orden incorrecto

Recomendamos utilizar el complemento cuando desee capturar una ubicación precisa de un usuario. Esta podría ser la ubicación exacta de la puerta de entrada de su cliente, por ejemplo, para entregar su compra.

Configuración

Habilitar el complemento en una publicación o página

Para habilitar el complemento en una publicación o página, simplemente agregue un campo de entrada de texto, contenido dentro de un formulario, y agregue la identificación del campo a la opción de configuración Selector (es) de entrada del complemento como se describe a continuación.

Configuración de la API de what3words

Se requiere una clave API de what3words para utilizar este complemento, ya que se autentica e interactúa con la API de what3words.
Si aún no tiene una clave API de what3words, puede registrarse rápida y fácilmente para obtener una.

Configuración general

• Selectores de entrada (solo WordPress): los campos de entrada que el complemento está configurado para buscar direcciones de 3 palabras, especificados como una lista de selectores css. Varios campos pueden ser suministros usando comas, por ejemplo, “.class, #id”.

• Texto de marcador de posición de entrada: un marcador de posición opcional que se mostrará en los campos de entrada configurados en la opción Selector (es) de entrada. Recomendamos proporcionar un ejemplo de la dirección de what3words aquí con “eg” para ilustrar cómo se debe ingresar una dirección de what3words, por ejemplo, “eg index.home.raft”.

Soporte WooCommerce

El complemento también le permite agregar automáticamente un campo de validación de dirección de 3 palabras a un formulario de pago de WooCommerce y guardar la dirección de 3 palabras con los detalles del pedido del cliente. Al habilitar la integración de pago de WooCommerce, el #shipping_w3w y #billing_w3w Los selectores se agregarán automáticamente a la lista de Input Selector(s).

Soporte y uso de filtros

El complemento de what3words AutoSuggest admite un solo filtro para cambiar el conjunto predeterminado de configuraciones y opciones de instalación en el momento de la activación del complemento.

what3wordssearchbox_default_settings

Se aplica al conjunto predeterminado de configuraciones y opciones de complementos. Tenga en cuenta que este filtro se llama una vez, tras la activación del complemento, cuando no existen configuraciones / opciones del complemento de what3words AutoSuggest en la base de datos.

Ejemplo: Agregue la fecha y la hora en que se activó el complemento por primera vez

add_filter ('what3wordssearchbox_default_settings', 'add_activation_timestamp');

function add_activation_timestamp ($options) {
    // options = array (option name => option value)
    $options['plugin_activation_timestamp'] = date (DATE_ATOM);

    return $options;
}