Plugin WordPress ts-immo-sync

Vue d'ensemble

ts-immo-sync est un plugin WordPress qui connecte votre site à la plateforme TS-Immo. Il synchronise automatiquement vos biens immobiliers, génère des pages de détail et fournit des shortcodes pour afficher vos annonces n'importe où sur votre site.

Installation

Installez le plugin via WP-CLI ou en téléchargeant l'archive depuis votre espace client TS-Immo :

# Via WP-CLI
wp plugin install ts-immo-sync --activate

# Ou télécharger le .zip et installer via
# Tableau de bord WordPress > Extensions > Téléverser

Après activation, rendez-vous dans Réglages > TS-Immo Sync pour configurer votre clé API.

Configuration

Vous pouvez configurer le plugin via l'interface graphique ou directement dans wp-config.php :

// wp-config.php ou via l'interface admin
define('TS_IMMO_API_KEY', 'votre-cle-api');
define('TS_IMMO_API_URL', 'https://api.ts-immo.org/v1');
define('TS_IMMO_SYNC_INTERVAL', 300); // secondes

Shortcodes

Utilisez ces shortcodes dans vos pages, articles ou widgets WordPress :

// Afficher la liste des propriétés
[ts_immo_listings limit="12" type="sale"]

// Afficher une propriété spécifique
[ts_immo_property id="123"]

// Formulaire de recherche
[ts_immo_search fields="type,price,location"]

// Carte interactive
[ts_immo_map zoom="12" lat="48.8566" lng="2.3522"]

Actions & Filtres

Étendez le comportement du plugin grâce aux hooks WordPress :

// Action : après synchronisation
add_action('ts_immo_after_sync', function($properties) {
    foreach ($properties as $property) {
        // Traitement personnalisé
        error_log('Sync: ' . $property->id);
    }
});

// Filtre : modifier les données avant import
add_filter('ts_immo_before_import', function($data) {
    $data['custom_field'] = 'valeur';
    return $data;
});

// Action : propriété créée
add_action('ts_immo_property_created', function($post_id, $property) {
    // Notifier, envoyer email, etc.
}, 10, 2);

Synchronisation

La synchronisation s'exécute automatiquement selon l'intervalle configuré (défaut : toutes les 5 minutes). Vous pouvez aussi la déclencher manuellement :

// Forcer une synchronisation manuelle via WP-CLI
wp ts-immo sync --all

// Synchroniser un seul bien
wp ts-immo sync --id=456

// Voir le statut de la dernière synchronisation
wp ts-immo status

Personnalisation des templates

Copiez les templates dans votre thème enfant pour les personnaliser sans risquer les mises à jour :

// Dans votre thème enfant : copier et personnaliser
wp-content/
  themes/
    mon-theme-enfant/
      ts-immo/
        listing.php        // Liste des propriétés
        single.php         // Fiche propriété
        search-form.php    // Formulaire de recherche
        map.php            // Carte

Dépannage

En cas de problème, activez le mode debug dans les réglages du plugin pour voir les logs détaillés.