Marcadores de posición básicos de Google Maps

FAQ

Instrucciones de instalación

For help installing this (or any other) WordPress plugin, please read the Managing Plugins article on the Codex.

Basic Usage:

1. After activating the plugin, go to the ‘Basic Google Maps Placemarks’ page under the Settings menu. Enter the address that the map should be centered on.
2. Create a page or post where you’d like to embed the map, and type [bgmp-map] in the content area.
3. Go to the Placemarks menu and click ‘Add New’. Enter the title, address, etc.
4. Click on ‘Set Featured Image’ to upload the icon.
5. Click on the ‘Publish’ or ‘Update’ button to save the placemark.

Advanced Usage:

Multiple maps with different locations, zoom levels, etc:

1. Just add the extra parameters to the [bgmp-map] shortcode. Here’s an example of the different ones you can use:

[bgmp-map categories=»parks,restaurants» width=»500″ height=»500″]

[bgmp-map placemark=»105″ center=»chicago» zoom=»10″ type=»terrain»]

Multiple maps with different placemarks:

1. Go to the Placemarks menu and click on Categories, and add a category for each set of placemarks.
2. Edit your placemarks and click on the category you want to assign them to.
3. Edit the place where the map is embedded and add the category parameter to the shortcode. For example: [bgmp-map categories=»restaurants,record-stores»] or [bgmp-map categories=»parks»]. Use the category’s slug, which is displayed on the Categories page in step 1. Separate each slug with a comma.
4. You can add the [bgmp-map] shortcode to multiple pages, each time using a different set of categories.

Setting the stacking order of overlapping markers:

1. Choose which placemark you want to appear on top and edit it.
2. Enter a number in the Stacking Order meta box in the right column that is greater than the other placemark’s stacking order.

Adding a text-based list of placemarks to a page:

1. Edit the post or page you want the list to appear on.
2. Type [bgmp-list] in the context area.
3. Click the ‘Publish’ or ‘Update’ button.
4. (optional) You can specifiy a specific category or categories to pull from. e.g., [bgmp-list categories=»record-stores,parks»]
5. (optional) You can add «View on Map» links to each item in the list, which will open the corresponding marker’s info window. e.g., [bgmp-list viewonmap=»true»]

Using [bgmp-map] in a template file with do_shortcode():

For efficiency, the plugin only loads the required JavaScript, CSS and markup files on pages where it detects the map shortcode is being called. It’s not practical to detect when do_shortcode() is used in a template, so you need to manually let the plugin know to load the files by adding this code to your theme:

function bgmpShortcodeCalled()
{
    global $post;

    $shortcodePageSlugs = array(
        'hello-world',
        'second-page-slug'
    );

    if( $post )
        if( in_array( $post->post_name, $shortcodePageSlugs ) )
            add_filter( 'bgmp_map-shortcode-called', '__return_true' );
}
add_action( 'wp', 'bgmpShortcodeCalled' );

Copy and paste that into your theme’s functions.php file or a functionality plugin, update the function names and filter arguments, and then add the slugs of any pages/posts containing the map to $shortcodePageSlugs.

That won’t work for the home page, though. If you want to target the home page, or any other pages with conditional tags, you can do it like this:

function bgmpShortcodeCalled()
{
    global $post;

    if( ( function_exists( 'is_front_page' ) && is_front_page() ) || ( function_exists( 'is_home_page' ) && is_home_page() ) )
        add_filter( 'bgmp_map-shortcode-called', '__return_true' );
}
add_action( 'wp', 'bgmpShortcodeCalled' );

Before version 1.9, you needed to use the bgmp_map-shortcode-arguments filter to pass shortcode arguments when calling do_shortcode() from a template, but that is no longer necessary. You can simply pass the arguments in the do_shortcode() call, like this:

do_shortcode( '[bgmp-map center="Boston" zoom="5"]' );

Check the FAQ and support forum if you have any questions.

¿Cómo uso el plugin?

Lee las instrucciones en la página de instalación. Si todavía tienes preguntas, lee esta FAQ y busca respuestas en el foro de soporte. Si no encuentras una respuesta, inicia un nuevo hilo en los foros.

¿Cómo puedo obtener ayuda cuando tengo un problema?

No me envíes correos electrónicos, a menos que sea un problema de seguridad. Borro automáticamente cualquier solicitud de soporte que llegue por correo electrónico. En su lugar, sigue los pasos que se indican a continuación.

1. Lee la página de instalación.
2. Lee las respuestas en esta FAQ.
3. Revisa el foro de soporte, porque hay una buena posibilidad de que tu problema ya haya sido tratado allí.
4. Consulta la página de otras notas para conocer los conflictos conocidos con otros plugins.

Si aún necesitas ayuda, sigue estas instrucciones:

1. Desactiva todos los demás plugins y cambia al tema predeterminado, luego verifica si el problema continúa. Si no ocurre, entonces el problema podría estar realmente en tu tema u otros plugins que tengas instalados.
2. Si el problema continúa, inicia un nuevo hilo en el foro con una descripción detallada de tu problema y la URL de la página de tu sitio donde colocaste el mapa. Por favor, copia/pega cualquier mensaje de error tal como aparece. Las capturas de pantalla también pueden ser muy útiles. Y, por favor, sé respetuoso.
3. Marca la casilla «Avisarme sobre respuestas por correo electrónico» para que no te pierdas ninguna respuesta.

I often don’t have time to provide support, but if I can’t there’s still a chance that another user will be able to help you. If not, I’d recommend hiring a developer. See the Customization section on the Other Notes page for more info on that.

¿El plugin es compatible con [característica]? / ¿Cómo puedo hacer que el plugin realice [característica]?

All of the features that the plugin supports are documented on these pages. If you don’t see a feature mentioned, then that means that the plugin doesn’t support it. You’ll need to write the extra code yourself if you want to add that feature to the plugin, or hire someone to do it for you (see the Customization section on the Other Notes page). There are filters throughout the core code to support customization. If you need a hook or filter that doesn’t currently exist, add a post to the support forums to request it and I’ll add it to the next version.

También puedes intentar buscar en los foros de soporte por si otros ya han encontrado una forma de hacerlo.

Si logras que funcione con tu código personalizado, compártelo en los foros de soporte para que otros puedan beneficiarse de tu trabajo.

¿Por qué recibo un error que dice que necesito una clave API?

Sometimes Google requires you to obtain an API from them in order to use the Google Maps and Geocoding services on your site. You can go to the Settings screen for instructions on how to get them.

Los desarrolladores también pueden usar los filtros bgmp_maps-api-url-parameters y bgmp_geocoding-api-url-parameters para asignar claves de forma programática.

¿Qué significa el error «No se pudo geocodificar esa dirección, por favor asegúrate de que sea correcta»?

Hay varias posibles causas para este error, pero generalmente se clasifican en dos categorías diferentes.

1. Google Maps no reconoció la dirección que introdujiste.
2. El plugin no pudo conectarse a la API de Google Maps para geocodificar la dirección.

Si el error va seguido de algo similar al ejemplo siguiente, entonces el problema estaba en la conexión con la API de Maps:

Geocode response:

stdClass Object
(
    [results] => Array
    (
    )
    [status] => OVER_QUERY_LIMIT
)

Si el problema está en la dirección, puedes intentar introducirla en un formato diferente. Por ejemplo, en lugar de «5th Ave and Blanchard St, Seattle», prueba con «2124 5th Ave, 98121». También puedes intentar usar coordenadas de latitud/longitud para evitar por completo el proceso de geocodificación; consulta las otras respuestas de las FAQ para obtener más detalles al respecto.

Si el problema está en la conexión, algunas de las posibles causas son:

1. Google Maps establece un límite en la cantidad de solicitudes de geocodificación que atenderá por día. Si estás utilizando alojamiento compartido, podría haber otros sitios en tu servidor o bloque de red que también estén haciendo solicitudes, y habrás alcanzado el límite del día. Si este es el problema, probablemente necesitarás pedirle a tu proveedor de alojamiento que te traslade a un VPS propio, o simplemente esperar hasta mañana y volver a intentarlo.
2. Podría haber problemas con tu red o servidor que estén interfiriendo con la conexión. Si este es el problema, tu proveedor de alojamiento web puede ayudarte a solucionarlo.
3. Google podría estar bloqueando las solicitudes desde la dirección IP o el bloque de red de tu servidor debido a abusos o violaciones de sus términos de servicio. Las violaciones podrían ser causadas por tu sitio o por otro sitio en tu servidor/bloque de red. Si este es el problema, tu proveedor de alojamiento web puede ayudarte a solucionarlo. Una vez que eliminen el problema, podría comenzar a funcionar nuevamente después de un tiempo (probablemente entre 1 y 7 días), o quizá necesiten contactar a Google para solicitar que el servidor sea eliminado de la lista negra.

También puedes intentar usar coordenadas de latitud/longitud para evitar por completo el proceso de geocodificación; consulta las otras respuestas de las FAQ para obtener más detalles al respecto.

La página dice «Cargando mapa…», pero el mapa nunca se muestra.

Comprueba si hay errores de JavaScript abriendo la consola de JavaScript en tu navegador web. Un error causado por otros plugins o tu tema puede impedir que BGMP funcione. Necesitarás corregir los errores o cambiar a un plugin/tema diferente.

Además, asegúrate de que tu tema esté llamando a wp_footer() justo antes de la etiqueta de cierre body en footer.php.

El mapa no se ve correctamente.

Probablemente esto se deba a que algunas reglas de la hoja de estilos de tu tema se están aplicando al mapa. Contacta con el desarrollador de tu tema para recibir asesoramiento sobre cómo sobrescribir dichas reglas.

¿Puedo usar coordenadas para establecer el marcador, en lugar de una dirección?

Yes. You can type anything into the Address field that you would type into a standard Google Maps search field, which includes coordinates.

Si el plugin reconoce tu entrada como coordenadas, entonces creará el marcador en ese punto exacto del mapa. Si no lo hace, intentará geocodificarlas, lo que a veces puede dar como resultado una ubicación diferente a la que pretendías. Para ayudar al plugin a reconocer las coordenadas, asegúrate de que estén en notación decimal (por ejemplo, 48.61322,-123.3465) en lugar de notación de minutos/segundos. La latitud y la longitud deben estar separadas por una coma y no pueden contener letras ni símbolos. Si tu entrada ha sido geocodificada, verás una nota junto al campo de dirección que indica las coordenadas geocodificadas, y el plugin las usará para crear el marcador en el mapa; si no ves esa nota, eso significa que tu entrada no fue geocodificada y se usarán tus coordenadas exactas para colocar el marcador.

If you’re having a hard time getting a set of coordinates to work, try visiting Latitude and Longitude of a Point and use the coordinates they give you.

Ninguno de los marcadores se muestra en el mapa.

Si tu tema está llamando a add_theme_support( 'post-thumbnails' ) y pasando una lista específica de tipos de contenido —en lugar de activar el soporte para todos los tipos de contenido— entonces debería comprobar si algunos tipos de contenido ya están registrados e incluirlos también. Esto solo se aplica si se engancha en after_theme_setup con una prioridad superior a 10. Contacta con el desarrollador de tu tema y pídele que corrija su código.

Also check the Other Notes page for known conflicts with other plugins.

¿Puedo cambiar el icono por defecto?

Sí, si quieres usar el mismo icono personalizado para todos los marcadores por defecto, en lugar de tener que configurarlo en cada marcador individual, puedes añadir esto en el archivo functions.php de tu tema o en un plugin de funcionalidades:

function setBGMPDefaultIcon( $iconURL )
{
    return get_bloginfo( 'stylesheet_directory' ) . '/images/bgmp-default-icon.png';
}
add_filter( 'bgmp_default-icon', 'setBGMPDefaultIcon' );

La cadena que devuelvas debe ser la URL completa del nuevo icono.

¿Cómo puedo establecer el icono por defecto según la categoría u otra condición?

Si solo quieres reemplazar el marcador predeterminado bajo ciertas condiciones (por ejemplo, cuando el marcador está asignado a una categoría específica), entonces puedes hacerlo usando algo como esto:

function setBGMPDefaultIconByCategory( $iconURL, $placemarkID )
{
    $placemarkCategories = wp_get_object_terms( $placemarkID, 'bgmp-category' );

    foreach( $placemarkCategories as $pc )
    {
        switch( $pc->slug )
        {
            case 'restaurants':
                $iconURL = get_bloginfo( 'stylesheet_directory' ) . '/images/marker-icons/restaurants.png';
            break;

            case 'book-stores':
                $iconURL = get_bloginfo( 'stylesheet_directory' ) . '/images/marker-icons/book-stores.png';
            break;

            default:
                $iconURL = get_bloginfo( 'stylesheet_directory' ) . '/images/marker-icons/pin.png';
            break;
        }
    }

    return $iconURL;
}
add_filter( 'bgmp_default-icon', 'setBGMPDefaultIconByCategory', 10, 2 );

A continuación se muestra otro ejemplo para utilizar el ID de la marca de posición:

function setBGMPDefaultIconByID( $iconURL, $placemarkID )
{
    if( $placemarkID == 352 )
        $iconURL = get_bloginfo( 'stylesheet_directory' ) . '/images/bgmp-default-icon.png';

    return $iconURL;
}
add_filter( 'bgmp_default-icon', 'setBGMPDefaultIcon', 10, 2 );

La cadena que devuelvas debe ser la URL completa del nuevo icono.

¿Puedo incrustar más de un mapa en la misma página?

No, la API de JavaScript de Google Maps solo es compatible con un mapa por página. Sin embargo, puedes tener mapas diferentes en páginas separadas. Consulta la página de instalación para ver las instrucciones sobre cómo hacer que los diferentes mapas tengan distintas ubicaciones centrales, muestren distintos conjuntos de marcadores, etc.

¿Cómo puedo sobrescribir los estilos que el plugin aplica al mapa?

The width/height of the map and marker information windows are always defined in the Settings, but you can override everything else by putting this code in your theme’s functions.php file or a functionality plugin:

function setBGMPStyle()
{
    wp_deregister_style( 'bgmp_style' );
    wp_register_style(
        'bgmp_style',
        get_bloginfo('template_url') . '/bgmp-style.css'
    );
    wp_enqueue_style( 'bgmp_style' );
}
add_action('init', 'setBGMPStyle');

Then create a bgmp-style.css file inside your theme directory or a child theme and put your styles there. If you’d prefer, you could also just make it an empty file and put the styles in your main style.css, but either way you need to register and enqueue a style with the bgmp_style handle, because the plugin checks to make sure the CSS and JavaScript files are loaded before embedding the map.

Recibo un error al usar do_shortcode() para llamar al shortcode del mapa.

Consulta las instrucciones en la página de instalación.

¿Cómo puedo hacer para que el ancho y alto de la ventana de información siempre sean del mismo tamaño?

Añade los siguientes estilos al archivo style.css de tu tema o a un tema hijo:

.bgmp_placemark
{
    width: 450px;
    height: 350px;
}

¿Pueden los usuarios registrados crear sus propios marcadores?

Sí. El plugin crea un tipo de contenido personalizado, por lo que tiene la misma estructura de permisos que las entradas/páginas normales.

He actualizado a la última versión y ahora algo está funcionando mal.

Si estás usando un plugin de caché como WP Super Cache, asegúrate de borrar el contenido de la caché para que se carguen los archivos más recientes y luego actualiza tu navegador.

Si actualizaste otros plugins al mismo tiempo, es posible que uno de ellos esté provocando un error de JavaScript que rompa toda la página u otro tipo de conflicto. Comprueba si BGMP funciona con el tema por defecto y sin otros plugins activados.

Si todavía tienes problemas, crea un informe detallado en el foro de soporte (consulta la pregunta «¿Cómo puedo obtener ayuda cuando tengo un problema?» más arriba), y luego descarga una versión anterior para usar hasta que se solucione el problema.

Además, ten en cuenta que los profesionales no solo instalan actualizaciones de plugins en su sitio web en producción y luego se enfadan cuando inevitablemente se encuentran con una situación en la que una actualización provoca que el sitio web deje de funcionar. La forma correcta de hacerlo es tener un servidor de pruebas donde pruebes todas las actualizaciones y cambios de código, y luego transferirlos al servidor en producción una vez que estés seguro de que todo funciona correctamente. Si tu sitio web es de misión crítica, esto es lo que necesitas hacer. Si no eres capaz o no estás dispuesto a hacerlo tú mismo, entonces necesitas contratar a un desarrollador para que gestione el proceso por ti. Si no haces estas cosas, no tendrás a nadie a quien culpar cuando algo salga mal. Puedes suscribirte a la lista de correo electrónico de probadores de BGMP para recibir notificaciones cuando haya nuevas versiones candidatas disponibles para probar.

¿Este plugin es seguro?

He hecho todo lo posible para asegurarme de que lo sea, pero por si acaso se me pasó algo, también ofrezco una recompensa de seguridad por cualquier vulnerabilidad que se pueda encontrar y divulgar de forma privada en cualquiera de mis plugins.

¿Hay algún gancho que pueda usar para modificar o ampliar el plugin?

Sí, he intentado añadir filtros para todo lo que razonablemente puedas necesitar; simplemente revisa el código fuente para buscarlos. Si necesitas un filtro o acción que no esté, haz una solicitud en el foro de soporte y lo añadiré a la próxima versión.