Jak korzystać z API?

Opublikowano: 2 miesiące 3 dni temu Autor: admin

Od wersji 8.0 iDir oferuje ujednolicone API za pomocą którego można stworzyć automatyczne dodawarki, sprawdzarki albo panele moderacji centralnej. Niniejszy post jest krótkim wprowadzeniem do korzystania z API. Do testowania poszczególnych requestów polecam zaopatrzyć się w darmowy program Postman.

# Import dostępnych enpointów

Mając zainstalowany program Postman, w górnym menu należy wybrać Import, zaznaczyć zakładkę Link i wstawić link z oficjalnej dokumentacji API iDir https://demo.idir.intelekt.net.pl/docs/collection.json.

# Dodawanie nowych wpisów

Domyślnie w iDir dodawanie nowych wpisów dostępne jest zarówno dla zalogowanych użytkowników serwisu jak i gości. W przypadku dodawania wpisów jako gość, wymagane jest dodatkowo podanie unikalnego adresu email. Z racji tego API nie wymaga w tym przypadku autentykacji za pomocą tokena API.

Aby dodać wpis do katalogu należy znać ID grupy. Grupy można wyciągnąć za pomocą endpointu:

pokaż więcej »

Aktualizacja API dla dodawarek

Opublikowano: 2 miesiące 4 dni temu Autor: admin

Aktualizacja 8.0.0 dla iDir i 6.0.0 dla iCore zawiera:

  • dodano panel do generowania tokenów API dla użytkowników w profilu (tokeny służą do uproszczonej autentykacji przy korzystaniu z API)
  • dodano szereg nowych enpointów do API służących do dodawania, edytowania lub usuwania wpisów katalogu stron. Za ich pomocą można zbudować automatyczne dodawarki lub panele moderacji centralnej.
  • przygotowano dokładną dokumentację API przy użyciu narzędzia Laravel Scribe opisującą wszystkie dostępne endpointy wraz z przykładami użycia w różnych językach programowania.
  • dodano obsługę Recaptcha Invisible. Jest to token podobny do zwykłej recaptchy, ale wygodniejszy dla użytkownika, ponieważ potwierdzenie jest zintegrowane z przyciskiem wysyłającym formularz.

Prócz tego ogólna refaktoryzacja kodu i naprawa drobniejszych błędów.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Polecamy zapoznać się również z podstawową instrukcją korzystania z API.

Aktualizacja tabel dla edytora tekstu

Opublikowano: 4 miesiące 1 tydzień temu Autor: admin

Aktualizacja 7.2.0 dla iDir i 5.2.0 dla iCore wprowadza wsparcie dla tabel w edytorze Trumbowyg. Przycisk tabel znajduje się obok przycisku wstawiania obrazów na pasku narzędzi. Tabelę można ostylować w edytorze HTML według standardów Bootstrap.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Mini-aktualizacja z poprawkami

Opublikowano: 4 miesiące 1 tydzień temu Autor: admin

Aktualizacja 7.1.0 dla iDir i 5.1.0 dla iCore wprowadza:

  • zmieniono część wyświetlanych komunikatów o sukcesie z alertów na toasty (głównie w formularzach zamykających modal)
  • dodano możliwość wyszukiwania powiązanego przez atrybuty modelu (pilotażowo póki co dostępne wyszukiwanie przez "id" w katalogu stron)
  • naprawiono błąd powodujący przesuwanie scrolla na górę w edytorze trumbowyg w edycji tekstu przez textarea
  • naprawiono błąd z nieprawidłowo skanującymi się kodami QR na urządzeniach z Androidem (podziękowania dla promuje.eu)
  • zmieniono kolejność wysyłania powiadomień, od teraz najpierw wysyłane są powiadomienia o zakończonych wpisach, a dopiero później o wygasających

Prócz tego ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja dashboardu

Opublikowano: 4 miesiące 3 tygodnie temu Autor: admin

Wszystkiego dobrego w Nowym Roku!

Z tej okazji długo wyczekiwana aktualizacja dla iCore i iDir. Lista zmian:

  • wprowadzono dashboard prezentujący kilka przydatnych wykresów oraz najnowsze wiadomości z bloga intelekt.net.pl
  • zmieniono wszystkie Bootstrap Modale na scrollable
  • zmieniono pasek narzędzi edytora Trumbowyg na fixed (zawieszony u góry ekranu) również w trybie normalnym (nie pełnoekranowym). Podziękowania dla firm-katalog.pl za znalezienie rozwiązania
  • dodano atrybut transition dla sidebara w panelu administracyjnym na urządzeniach mobilnych
  • zmieniono konfigurację routingu na zgodną z aktualnymi standardami Laravel-a oraz umożliwiono opcję wyłączenia poszczególnych grup
  • wszystkie skrypty JS otrzymały unikatowy namespace dzięki czemu można je dowolnie nadpisywać własnymi bez konieczności ingerencji w domyślne assety
  • dodano nowy endpoint dla API do pobierania kolekcji postów na blogu
  • naprawiono błąd który użytkownikom dodającym wpis bez rejestracji nie nadawał roli użytkownika

pokaż więcej »

Mini-aktualizacja - kody QR

Opublikowano: 5 miesięcy 2 tygodnie temu Autor: admin

Aktualizacja 6.1.0 dla iDir wprowadza:

  • automatycznie generowane kody QR dla płatności kodem SMS. Użytkownik nie musi już wpisywać ręcznie kodu i numeru.


Aktualizację można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Zniżka cen aplikacji iDir na Black Friday

Opublikowano: 6 miesięcy 1 dzień temu Autor: admin

Z okazji nadchodzącego Black Friday wszystkie ceny na licencje oprogramowania iDir zostały obniżone o -10%:

  • 1 licencja: 499.00 PLN 449.00 PLN
  • 5 licencji: 1999.00 PLN 1799.00 PLN
  • 10 licencji: 2999.00 PLN 2699.00 PLN

Ceny brutto. Wystawiam faktury VAT. Promocja potrwa do końca roku.

Wydany rok temu iDir to naturalny następca bardzo popularnego wiele lat temu w polskim SEO skryptu katalogowego SEOKatalog. Cały kod został przepisany na nowo przy użyciu nowoczesnego frameworka Laravel. Wyeliminowane zostały wszystkie ograniczenia starego silnika, dodano wiele nowych funkcjonalności i udogodnień dla użytkowników oraz moderacji.

W ciągu roku od premiery aplikacja doczekała się wielu aktualizacji zwiększających funkcjonalność oraz poprawiających optymalizację i stabilność działania. W grudniu planowana jest kolejna aktualizacja wprowadzająca m.in. dashboard zawierający statystykę oraz najświeższe wiadomości.

W przypadku jakichkolwiek pytań lub sugestii zapraszam do kontaktu przez formularz kontaktowy.


Mini-aktualizacja - zniżki

Opublikowano: 6 miesięcy 2 dni temu Autor: admin

Aktualizacja 6.0.0 dla iDir dostępna w repozytorium. Zmiany:

  • możliwość definiowania zniżek okolicznościowych dla poszczególnych cen
  • naprawa błędu wyświetlania powiększonych miniaturek w panelu administracyjnym na przeglądarce Google Chrome (błąd nie występował w przypadku cachowanych miniaturek)

Prócz tego ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.


Mini-aktualizacja rel canonical

Opublikowano: 8 miesięcy 2 tygodnie temu Autor: admin

Dostępna jest mini aktualizacja 3.1.0 dla iCore oraz 5.1.0 dla iDir wprowadzająca adresy kanoniczne pozwalające uniknąć duplikatów indeksujących się podstron serwisu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja typu minor, wymaga drobnej zmiany w szablonie.


Aktualizacja API

Opublikowano: 9 miesięcy 4 dni temu Autor: admin

Aktualizacja 5.0.0 dla iDir oraz 3.0.0 dla iCore wprowadza:

  • udostępnione pierwsze endpointy API dotyczące kategorii, tagów i użytkowników, możliwy rozwój API w przyszłości do celów wykorzystania w dodawarkach, panelach moderacji centralnej oraz aplikacjach na urządzenia mobilne
  • wprowadzono możliwość zmiany użytkownika w formie bootstrap select z autocomplete dla postów, podstron oraz wpisów katalogu stron w oknie pełnej edycji
  • zmiana metody wyboru kategorii oraz rodzica na ujednolicony bootstrap select z autocomplete

Prócz tego poprawki drobnych błędów oraz duża refaktoryzacja kodu dostosowująca aplikację do działania z API.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja typu major, wymaga zmian w szablonie.

Jak pobrać listę ID kategorii?

Opublikowano: 10 miesięcy 2 dni temu Autor: admin

Od jakiegoś czasu niektórzy właściciele katalogów na iDir otrzymują prośbę od twórców pewnej dodawarki o przesłanie zrzutu SQL z listą ID kategorii. Autor dodawarki tłumaczy to koniecznością posiadania tych ID do celów dodawania wpisów. Jest to rozwiązanie wyjątkowo nieefektywne gdyż:

  • każdy katalog ma inną bazę kategorii, jeśli dodawarka będzie dodawać do powiedzmy 1mln katalogów, a każdy z nich ma po 300 kategorii dodawarka będzie musiała przechowywać w swojej bazie 300mln rekordów samych kategorii
  • tabela kategorii nie jest stała. Właściciel każdego katalogu może w pewnym momencie w przyszłości usunąć jakąś kategorię co poskutkuje tym, że dodawarka dodając do takiego nieistniejącego ID otrzyma walidacyjny komunikat o nieprawidłowej kategorii

Jeśli mimo wszystko chcą Państwo udostępnić autorom tej bezsensownej z mojego punktu widzenia - dodawarki listę ID swoich kategorii proszę postępować według poniższej instrukcji:

  1. Wejść do phpMyAdmin (dane logowania znajdują się w pliku ENV), wybrać bazę katalogu, wybrać zakładkę SQL lub Kwerenda
  2. Wkleić i wykonać:
    SELECT `categories`.`id`, `categories`.`name`, `categories`.`parent_id` FROM `categories` WHERE `categories`.`status` = 1 AND `categories`.`model_type` = "N1ebieski\\IDir\\Models\\Dir" ORDER BY `categories`.`parent_id` ASC;
  3. Na samym dole w belce "Operacje na wynikach zapytania" kliknąć Eksport
  4. Wybrać metoda eksportu: szybka; format: SQL, kliknąć Wykonaj

Aktualizacja tagów już dostępna

Opublikowano: 1 rok 3 dni temu Autor: admin

Aktualizacja o numerze 4.2.0 dla iDir oraz 2.4.0 dla iCore jest już dostępna w repozytorium. Zmiany:

  • ulepszony importer SEOKatalogu. Od teraz możliwe jest zdefiniowanie ilości workerów zajmujących się asynchronicznie procesami co kilkukrotnie przyśpiesza czas importu
  • nowe okno konfiguracji tagów w panelu administracyjnym. Moderator o stosownych uprawnieniach może poprawiać tagi, dodawać nowe oraz usuwać istniejące
  • dodano label dla dodatkowych pól formularza typu select zdefiniowanych jako opcjonalne, tak aby użytkownik mógł pozostawić te pole jako puste, niewypełnione
  • dodano nową opcję konfiguracją dla tagów umożliwiającą adminowi ustalenie maksymalnej ilości znaków na tag

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja silnika wyszukiwarki

Opublikowano: 1 rok 1 miesiąc temu Autor: admin

Aktualizacja o numerze 4.1.0 dla iDir oraz 2.3.0 dla iCore jest już dostępna w repozytorium. Zmiany:

  • ulepszono silnik wyszukiwarki. Od teraz treści prezentowane są w kolejności priorytetu występującej w nich szukanej frazy. Na przykład wpis katalogu o tytule "Apartamenty" będzie wyświetlany wyżej niż taki który taką frazę posiada wyłącznie w opisie
  • dodano transakcje dla wszystkich złożonych operacji bazodanowych
  • naprawiono błąd pozwalający na dodanie duplikatów kodów manualnych. Od teraz importowany jest wyłącznie pierwszy kod, pozostałe duplikaty na liście zostaną zignorowane
  • zmieniono domyślny sposób sortowania cen. Od teraz prezentowane są w kolejności pozycji grup do których przynależą

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacja nie wymaga jakichkolwiek zmian w szablonie.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja płatności PayPal już dostępna

Opublikowano: 1 rok 1 miesiąc temu Autor: admin

Aktualizacja 4.0.0 dla iDir wprowadza następujące zmiany:

  • konfiguracja cen w panelu administracyjnym została przeniesiona z konfiguracji grup do osobnego panelu. Powinno poprawić to czytelność, zwłaszcza, że w planach jest dodanie nowych metod płatności
  • nowa metoda płatności - automatyczny PayPal bez konieczności pośrednictwa Cashbill
  • nowy parametr dla komponentu siatki kategorii umożliwiający wyświetlanie listy podkategorii po rodzicu; komponent został też domyślnie przeniesiony z podstrony wpisu na stronę główną i podstrony kategorii

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aplikacja iCore dostępna w sprzedaży

Opublikowano: 1 rok 2 miesiące temu Autor: admin

Skrypt z funkcjonalnością mini bloga - iCore został od dzisiaj udostępniony w sprzedaży jako niezależna aplikacja. Projekt stanowi ciekawą alternatywę dla Wordpress. Z racji zastosowanego frameworka Laravel można go dowolnie modyfikować do własnych potrzeb, z uwzględnieniem gruntownych zmian w silniku. iCore stanowi moduł główny dla pozostałych aplikacji w sklepie na nim bazujących (np. iDir), co gwarantuje jego stały rozwój i częste aktualizacje.

Szczegółowy wykaz funkcjonalności można znaleźć w dokumentacji.

Responsywny skrypt bloga w Bootstrap

pokaż więcej »

Aktualizacja menedżera plików już dostępna

Opublikowano: 1 rok 2 miesiące temu Autor: admin

Aktualizacja 2.0.0 dla iCore (3.0.0 dla iDir) jest już dostępna, a w niej:

  • nowa funkcjonalność menedżera plików zintegrowanego z edytorem treści
  • automatyczny tryb wyświetlania plików graficznych w postach i podstronach w trybie lazy-load oraz lightbox
  • możliwość wyłączenia automatycznego ukrywania navbara
  • domyślnie automatyczne powiększanie obiektów textarea na stronie podczas wpisywania tekstu

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja komponentu linków już dostępna

Opublikowano: 1 rok 4 miesiące temu Autor: admin

Mini aktualizacja 1.5.0 dla iCore jest już dostępna, a w niej:

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji dostępna jest w dokumentacji.

Aktualizacja systemu mailingu już dostępna

Opublikowano: 1 rok 5 miesięcy temu Autor: admin

Mini aktualizacja 1.4.0 dla iCore jest już dostępna, a w niej:

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacja typu minor, nie wymaga jakichkolwiek zmian w szablonie.

Aktualizacja uproszczonego dodawania wpisów już dostępna

Opublikowano: 1 rok 6 miesięcy temu Autor: admin

Ważna aktualizacja dla modułu iDir. Wersja 2.0 wprowadza m.in.:

  • możliwość dodawania wpisów przez niezalogowanych użytkowników (gości). Rejestracja konta odbywa się automatycznie bezpośrednio w formularzu dodawania wpisów po podaniu unikalnego adresu e-mail. W znaczny sposób upraszcza to całą procedurę dodawania, zwłaszcza dla firm zajmujących się katalogowaniem wpisów

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizację można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji z wersji 1.2 dostępna jest w dokumentacji.

Strona aplikacji na Facebook

Opublikowano: 1 rok 6 miesięcy temu Autor: admin

Od dzisiaj dostępna jest publicznie strona informacyjna projektu na Facebook. Na profilu publikowane będą informacje o najnowszych aktualizacjach i ewentualnych zniżkach. Istnieje również możliwość złożenia zamówienia przez Messenger lub korzystając z przycisku Kup teraz. Zapraszam do obserwowania.


Aktualizacja GUS już dostępna

Opublikowano: 1 rok 6 miesięcy temu Autor: admin

Kolejna duża aktualizacja aplikacji iDir została już udostępniona. Wersja 1.2 wprowadza nowe funkcjonalności:

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji z wersji 1.1 dostępna jest w dokumentacji.

Następna aktualizacja 1.3 wprowadzi możliwość dodawania wpisów dla niezalogowanych użytkowników (rejestracja będzie odbywać się bezpośrednio w formularzu dodawania wpisu).


Aktualizacja komponentów już dostępna

Opublikowano: 1 rok 7 miesięcy temu Autor: admin

Mini aktualizacja (1.1.4 dla iDir oraz 1.1.3 dla iCore) jest już dostępna. Nowości:

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacja nie wymaga jakichkolwiek zmian w szablonie.

Dlaczego działające strony zostają dezaktywowane z powodu błędnego statusu?

Opublikowano: 1 rok 7 miesięcy temu Autor: admin

iDir posiada system cron sprawdzający status każdego umieszczonego w katalogu wpisu. Sprawdzany jest wyłącznie nagłówek odpowiedzi:

  • w przypadku statusu 200 OK strona jest przepuszczana
  • w przypadku statusu 301 lub 302 Redirect sprawdzana jest trasa przekierowań (max. 5), jeśli nie kieruje do serwisów parkujących (np. aftermarket) strona jest przepuszczana
  • w przypadku statusu 4xx-5xx strona jest dezaktywowana

Niestety, czasami zdarza się sytuacja w której strona w przeglądarce na request użytkownika odpowiada prawidłowym statusem 200 OK, a dla bota wysyłającego request z serwera na którym umieszczony jest katalog odpowiada 403 Forbidden. Przyczyn takiego stanu rzeczy może być kilka:

  • serwer strony blokuje adres IP katalogu
  • serwer strony blokuje wszystkie User-Agent spoza whitelisty
  • serwer strony uznaje pozostałe elementy nagłówka requesta za podejrzane

Nie ma technicznego sposobu aby obejść te problemy z poziomu aplikacji iDir bez użycia proxy. To właściciel wpisu musi skonfigurować swój firewall aby przepuszczał bota sprawdzającego z iDir. Aby ułatwić ten proces, bot posługuje się określonym User-Agent zawierającym rodzaj aplikacji, jego wersję oraz host katalogu np:

iDir v1.1.3 demo.idir.intelekt.net.pl



Aktualizacja statystyk już dostępna

Opublikowano: 1 rok 8 miesięcy temu Autor: admin

Pierwsza z zapowiadanych aktualizacji po premierze została już udostępniona dla modułu iDir oraz iCore. Nowa wersja 1.1 wprowadza:

  • statystyki ilości wyświetleń dla wpisów, postów i podstron oraz ilości kliknięć wraz z wyliczonym CTR dla wpisów
  • komponent statystyk wyświetlający w footerze ilość wpisów, komentarzy, kategorii, datę ostatniej aktywności oraz ilość użytkowników online na stronie

Prócz tego poprawki drobnych błędów oraz ogólna refaktoryzacja kodu.

Aktualizacje można sprawdzić "na żywo" w wersji demonstracyjnej.

Procedura aktualizacji z wersji 1.0 dostępna jest w dokumentacji.

Następna aktualizacja 1.2 w przyszłym miesiącu wprowadzi nowe pole formularza do pobierania danych firmowych z GUS za pomocą numeru NIP, REGON lub KRS.

Aplikacja iDir dostępna już w sprzedaży

Opublikowano: 1 rok 9 miesięcy temu Autor: admin

Po 2 miesiącach testów w fazie beta, aplikacja iDir dostępna jest już publicznie w sprzedaży. iDir to naturalny następca bardzo popularnego wiele lat temu w polskim SEO skryptu katalogowego SEOKatalog. Cały kod został przepisany na nowo przy użyciu nowoczesnego frameworka Laravel. Wyeliminowane zostały wszystkie ograniczenia starego silnika, dodano wiele nowych funkcjonalności i udogodnień dla użytkowników oraz moderacji.

Responsywny skrypt katalogu stron w Bootstrap

pokaż więcej »