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.

Kluczowe 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ą [dp_import_doctor] (atrybuty: show=”fullname,score,avatar,specializations”) oraz [dp_import_reviews] (atrybuty: limit=”5″ min_rate=”0″ show_author=”yes” show_score=”yes” show_date=”yes”).
– Bezpieczna weryfikacja klucza API.

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 łączy się również z zewnętrzną usługą API w celu weryfikacji klucza API wprowadzonego przez użytkownika. Po podaniu prawidłowego klucza wszystkie funkcje PRO stają się dostępne dla użytkownika.

Jakie dane są wysyłane:
– Domena Twojej strony (np. example.com)
– Wprowadzony przez użytkownika klucz API

Kiedy dane są wysyłane:
Dane są wysyłane przy wprowadzeniu lub aktualizacji klucza API w ustawieniach wtyczki, niezależnie od tego, czy klucz jest poprawny, ponieważ API sprawdza jego poprawność. W wersji PRO dane są również wysyłane przy każdej aktualizacji danych lekarza, ocen i opinii, aby ponownie zweryfikować klucz API.

Cel połączenia:
Proces weryfikacji potwierdza, że użytkownik posiada ważną licencję na wersję PRO wtyczki. Bez zweryfikowanego klucza dostępne są tylko funkcje wersji FREE.

Dostawca usługi:
Usługa jest świadczona przez Kamila Nizińskiego.
– Strona internetowa usługi: https://www.dp-import.kamilnizinski.com/
– Endpoint API: https://kamilnizinski.com/wp-json/dp-import
– Regulamin usługi: https://www.dp-import.kamilnizinski.com/terms-of-service
– Polityka prywatności: https://www.dp-import.kamilnizinski.com/privacy-policy

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.