DP Import

Opis

Wtyczka DP Import pobiera publicznie dostępne dane lekarzy, oceny i opinie pacjentów z platform Docplanner (np. znanylekarz.pl, doctoralia.es, miodottore.it i innych) i umożliwia ich wyświetlenie na stronie WordPress za pomocą shortcode’ów. Dostępna w wersjach FREE i PRO.

Wersja FREE:
– Jeden profil lekarza lub specjalisty.
– Pobiera dane lekarza oraz wszystkie dostępne opinie.
– Ręczne aktualizacje profilu oraz widżet kokpitu.
– Natywne bloki: DP Import – Profil specjalisty oraz DP Import – Opinie.
– Shortcode’y: [dp_import_doctor] oraz [dp_import_reviews].

Wersja PRO:
– Wszystkie funkcje wersji FREE.
– Obsługa do 20 profili lekarzy lub specjalistów.
– Automatyczne globalne aktualizacje przez CRON, codziennie, co 3 dni lub raz w tygodniu.
– Zbiorcza aktualizacja wszystkich profili.
– Po wygaśnięciu wersji PRO istniejące profile pozostają widoczne i nadal mogą być aktualizowane indywidualnie.

Najważniejsze funkcje:
– Obsługuje platformy Docplanner na 13 rynkach (doctoraliar.com, doctoralia.com.br, doctoralia.cl, doctoralia.co, znamylekar.cz, jameda.de, doctoralia.es, miodottore.it, doctoralia.mx, doctoralia.pe, znanylekarz.pl, doctoralia.com.pt, doktortakvimi.com). Starsza domena doctoralia.com.mx pozostaje obsługiwana w celu zachowania kompatybilności.
– Wyświetla dane za pomocą natywnych bloków lub shortcode’ów [dp_import_doctor] (atrybuty: profile=”slug” show=”fullname,score,avatar,specializations”) oraz [dp_import_reviews] (atrybuty: profile=”slug” limit=”5″ min_rate=”0″ show_author=”yes” show_score=”yes” show_date=”yes”). Bloki i shortcode’y bez wybranego profilu korzystają z profilu utworzonego jako pierwszy.
– Bezpieczna obsługa licencji, procesu zakupu, zarządzania kontem i aktualizacji PRO za pośrednictwem Freemius.

Usługi zewnętrzne

Ta wtyczka łączy się ze stronami platformy Docplanner w celu zaimportowania publicznego profilu wybranego przez administratora. Żądanie jest wykonywane wyłącznie wtedy, gdy administrator dodaje profil lub ręcznie go aktualizuje, albo gdy uruchamiany jest włączony harmonogram PRO.

Połączenie z danymi Docplanner:
– Wybrany publiczny adres URL profilu oraz standardowe informacje techniczne wymagane do wykonania żądania HTTP są wysyłane do domeny Docplanner wskazanej przez administratora.
– Połączenie jest wykorzystywane wyłącznie do pobierania publicznych danych profilu wybranego specjalisty oraz publicznych opinii.
– Dostawcą jest Docplanner Group za pośrednictwem swoich regionalnych platform wymienionych w sekcji Kluczowe funkcje.
– Strona korporacyjna Docplanner: https://www.docplanner.com
– Warunki korzystania z usługi oraz polityka prywatności dotyczące danego profilu są dostępne na wybranej regionalnej platformie Docplanner.

Wtyczka korzysta również z Freemius do obsługi licencji, procesu zakupu, zarządzania kontem, dostarczania płatnych aktualizacji oraz opcjonalnego śledzenia sposobu korzystania z wtyczki.

Połączenie z Freemius:
– Nowym użytkownikom wyświetlany jest ekran zgody, na którym mogą pominąć opcjonalne śledzenie; funkcje wersji FREE nadal działają bez wyrażenia zgody.
– Połączenie z Freemius jest wymagane podczas zakupu, aktywacji lub zarządzania licencją PRO oraz podczas otrzymywania aktualizacji PRO.
– Po wyrażeniu zgody Freemius otrzymuje podstawowe informacje o koncie, witrynie, wtyczce i środowisku technicznym. Ekran zgody wyjaśnia, jakie dane są zbierane oraz jakie opcje są dostępne, zanim zostaną przesłane jakiekolwiek dane opcjonalne.
– Zaimportowane profile specjalistów, oceny i treść opinii nie są wysyłane do Freemius.
– Dostawca usługi: Freemius, Inc.
– Strona internetowa usługi: https://freemius.com
– Warunki korzystania z usługi: https://freemius.com/terms/
– Polityka prywatności: https://freemius.com/privacy/

API dla deweloperów

DP Import udostępnia stabilne API tylko do odczytu, przeznaczone do własnych integracji i shortcode’ów. Korzystaj z tych funkcji zamiast bezpośrednio odpytywać tabele wtyczki:

• dp_import_get_profile($selector = null) – Zwraca jeden profil wybrany na podstawie ID lub slugu. Bez podania selektora zwraca profil utworzony jako pierwszy.
• dp_import_get_profiles($args = []) – Zwraca profile. Obsługiwane argumenty: status (active, paused lub error), limit oraz offset. Wartość 0 dla limit zwraca wszystkie pasujące profile.
• dp_import_get_profile_reviews($selector = null, $args = []) – Zwraca widoczne opinie. Obsługiwane argumenty: limit, offset oraz min_rate. Wartość 0 dla limit zwraca wszystkie widoczne opinie.
• dp_import_get_profile_reviews_count($selector = null) – Zwraca liczbę widocznych opinii.

Ukryte opinie oraz wewnętrzne pola, takie jak hashe adresów URL, błędy synchronizacji i flagi widoczności, nigdy nie są zwracane przez publiczne API. Zwracane wartości są surowymi danymi zapisanymi w bazie i muszą zostać odpowiednio zabezpieczone dla kontekstu, w którym są wyświetlane.

Obiekty profilu zawierają: id, slug, source_url, source_host, external_id, fullname, specializations, score, reviews_count, avatar_url, status, last_sync_at oraz last_sync_status.

Obiekty opinii zawierają: id, profile_id, author, score, content oraz publication_date.

Przykładowy własny shortcode:

add_shortcode('my_specialist', function ($atts) {
    $atts = shortcode_atts(['profile' => ''], $atts);
    $profile = dp_import_get_profile($atts['profile'] ?: null);
    return $profile ? '<h2>' . esc_html($profile->fullname) . '</h2>' : '';
});

Przykładowe zapytanie o opinie:

$reviews = dp_import_get_profile_reviews('john-doe', [
    'limit' => 3,
    'offset' => 0,
    'min_rate' => 4,
]);

Akcja dp_import_ready jest wykonywana po zainicjalizowaniu API, shortcode’ów, zadań cron oraz handlerów AJAX.

Licencja

Wtyczka jest licencjonowana na zasadach GPLv2 lub nowszych. Możesz jej używać, modyfikować i rozpowszechniać zgodnie z warunkami tej licencji.

Zastrzeżenia

DP Import jest udostępniany „w stanie, w jakim jest”, bez jakichkolwiek gwarancji, w zakresie dozwolonym przez obowiązujące prawo.
DP Import jest niezależnym projektem i nie jest powiązany z Docplanner Group ani jej regionalnymi platformami, nie jest przez nie wspierany ani sponsorowany.
Administrator strony decyduje, które publiczne profile i opinie mają być importowane i wyświetlane, oraz odpowiada za posiadanie niezbędnych praw lub odpowiedniej podstawy prawnej, przekazanie wymaganych informacji, obsługę mających zastosowanie żądań osób, których dane dotyczą, a także przestrzeganie obowiązujących przepisów prawa i warunków platformy źródłowej.
Wtyczka nie świadczy porad prawnych ani nie gwarantuje zgodności z przepisami prawa. Autor nie ponosi odpowiedzialności za treści osób trzecich, decyzje podejmowane przez administratorów stron ani za zmiany lub dostępność zewnętrznych platform. Żadne postanowienie niniejszego zastrzeżenia nie wyłącza ani nie ogranicza odpowiedzialności, której nie można wyłączyć na mocy obowiązującego prawa.