Skip to content

Funkcje SAREscript

Przetwarzające teksty

lastchar - zwraca ostatni znak łańcucha

str_pad - uzupełnia łańcuch do długości znaków

str_split - dzieli łańcuch na części

str_repeat - powtarza łańcuch określoną liczbę razy

strtolower - zamienia wielkie litery na małe

strtoupper - zamienia małe litery na duże

trim - usuwa białe znaki z początku i końca łańcucha

substr - zwraca określony fragment łańcucha

substr_count - sprawdza liczbę wystąpień jednego łańcucha w drugim

ucfirst - Zamienia pierwszą literę stringa na wielką

strlen - Zwraca liczbę znaków z podanego parametru

strpos - Funkcja zwraca numeryczne stanowisko pierwszego wystąpienia szukanego znaku

Matematyczne i operujące na zmiennych

ok - zawsze zwraca true

not - neguje argument

rand - zwraca losową liczbę z określonego przedziału

next - przesuwa wskaźnik tablicy na kolejny element i zwraca jego wartość

isset - Funkcja sprawdza czy zmienna została utworzona

key - zwraca klucz bieżącego elementu tablicy

is_array - sprawdza czy podany parametr jest tablicą

in_array - sprawdza czy w tablicy znajduje się określona wartość

array_search - wyszukuje w tablicy wartość

array_pop - Funkcja zwraca ostatnią wartość tablicy jednocześnie usuwając tę wartość z tablicy

array_reverse - Funkcja odwraca kolejność elementów w tablicy

array_merge_indexes - Funkcja zwraca posortowaną tablicę indeksów opisujących tablice wejściowe

array_merge_values - Funkcja zwraca posortowaną tablicę wartości tablic wejściowych.

empty - sprawdza czy argument jest “pusty”

explode - zwraca tablicę zawierającą podzielony łańcuch

serialize - Funkcja generuje z przekazanego parametru postać do zapisu

unserialize - Funkcja przywraca dane wygenerowane przez funkcje serialize

base64_decode - Funkcja dekoduje dane zakodowane algorytmem MIME base64

base64_encode - Koduje podany ciąg danych algorytmem MIME base64

md5 - Funkcja zwraca 32 znakowy skrót MD5 dla wartości podanego parametru

urlencode - Funkcja zakoduje podany parametr tak by można było go bezpiecznie użyć jako część adresu

urldecode - Funkcja odkoduje parametr w którym zawartość jest zakodowana za pomocą urlencode

json_decode - Funkcja dekoduje łańcuch JSON

json_encode - Funkcja konwertuje parametr do formatu typu JSON

sort - Funkcja sortuje wartości od najmniejszej do największej

rsort - Funkcja sortuje wartości od największej do najmniejszej

asort - Funkcja sortuje parametr(tablicę) w kierunku od najmniejszej do największej wartości zachowując klucze zespolone z wartościami

arsort - Funkcja sortuje tablice w kierunku od największej do najmniejszej wartości zachowując klucze zespolone z wartościami

unset - Funkcja usuwa zmienną

min - Funkcja zwraca najmniejszą wartość z podanych parametrów

max - Funkcja zwraca największą wartość z podanych parametrów

iconv - Funkcja konwertuje $lancuch do nowego kodowania znaków.

count - zwraca liczbę elementów tablicy

current - zwraca wartość bieżącego elementu tablicy

intval - zamienia argument na liczbę całkowitą

Czas i data

date - zwraca odpowiednio sformatowana datę

time - zwraca aktualny uniksowy znacznik czasu

strtotime - Parsuje większość angielskich tekstowych opisów daty i czasu do uniksowego znacznika czasu

mktime - Oblicza uniksowy znacznik czasu dla podanej daty

passed_today - sprawdza czy od daty przekazanej jako pierwszy parametr, a daty przekazanej jako 3 parametr, minęło tyle czasu ile podano w parametrze drugim

Wyjściowe

barcode_ean13 - osadza w treści wiadomości znacznik HTML odpowiedzialny za wyświetlenie kodu kreskowego EAN13

print - osadza w treści wiadomości (lub wyświetla jako wynik działania) łańcuch wskazany jako argument

print_r - osadza w treści wiadomości (lub wyświetla jako wynik działania) wartość przekazanej zmiennej w czytelnej postaci

exit - Zatrzymuje wykonywanie dalszej części skryptu

Operujące na danych z bazy i zewnętrznych

registry_get - zwraca zawartość rejestru

registry_set - zapisuje wartość do rejestru

registry_unset - usuwa rejestr

registry_append - Funkcja dokleja podaną wartość do rejestru o podanej nazwie

bigregistry_get - zwraca zawartość rejestru typu BIG

bigregistry_set - zapisuje wartość do rejestru typu BIG

bigregistry_unset - usuwa rejestr typu BIG

bigregistry_append - Funkcja dokleja podaną wartość do rejestru typu BIG o podanej nazwie

get_url - pobiera treść znajdującą się pod wskazanym adresem URL

set_val - zapisuje do bazy dane skojarzone z bieżącym adresem e-mail

set_val_multiple - Funkcja ustawia w bazie cechy skojarzone z bieżącym adresem e-mail

get_val - zwraca dane skojarzone z bieżącym adresem e-mail

Kampanie

campaign_all - zwraca informacje o statusach dla wszystkich adresów, które brały udział w wybranej kampanii

campaign_clicked - zwraca liczbę klikniętych wiadomości podczas wskazanej kampanii dla bieżącego adresu e-mail

campaign_domains - zwraca tablicę, zawierającą dane dotyczące liczby wysłanych, zwrotów, otwarć, kliknięć i wypisań z poszczególnych domen dla kampanii

campaign_geoip - zwraca dane dotyczące geolokalizacji otwarć mailingu dla kampanii

campaign_total_clicked - zwraca łączną liczbę kliknięć podczas wskazanej kampanii

campaign_opened - zwraca liczbę otwartych wiadomości podczas wskazanej kampanii dla bieżącego adresu e-mail

campaign_total_opened - zwraca wskaźnik Openrate dla wskazanej kampanii

campaign_openrate - zwraca wskaźnik Openrate dla wskazanej kampanii, dla bieżącego adresu e-mail

campaign_total_openrate - zwraca liczbę otwartych wiadomości podczas wskazanej kampanii

campaign_ctr - zwraca wskaźnik CTR dla wskazanej kampanii, dla bieżącego adresu e-mail

campaign_total_ctr - zwraca wskaźnik CTR dla wskazanej kampanii

campaign_total_sent - zwraca liczbę maili wysłaną podczas wskazanej kampanii

campaign_mailings - zwraca tablicę numerów wysyłek w danej kampanii

campaign_distribution - Funkcja zwraca dane dotyczące liczby wysłanych, odebranych maili oraz liczby kliknięć, wypisów i zwrotów z podanej wysyłki

campaign_name - zwraca nazwę dla wskazanej kampanii

campaign_links - Funkcja zwraca tablice z informacjami dotyczącymi linków w podanej kampanii

campaign_tags - Funkcja zwraca tablice ze wszystkimi nazwami tagów oraz ilością kliknięć w dany tag w linku ze wszystkich wysyłek uczestniczących w podanej kampanii

campaign_list - Funkcja zwraca tablice z danymi o wszystkich kampaniach(nr kampanii oraz nazwa kampanii).

campaign_timeline_opened_day - Funkcja zwraca dane o ilości otwarć w określonych dniach podczas kampanii

campaign_timeline_opened_week - Funkcja zwraca dane o ilości otwarć w określonych dniach tygodnia podczas kampanii

campaign_timeline_clicked_hour - Funkcja zwraca dane o ilości kliknięć w określonych godzinach podczas kampanii

campaign_timeline_clicked_day - Funkcja zwraca dane o ilości kliknięć w określonych dniach podczas kampanii

campaign_total_bounced - zwraca całkowitą ilość zwrotów dla podanego jako parametr numeru kampanii

campaign_total_opted_out - zwraca ilość adresów, które wypisały się podczas wybranej kampanii

Mailing

bind_email - Ustawia kontekst adresu email jako bieżący

bind_hash - ustawia kontekst zahashowanego adresu email jako bieżący

mailing_all - Funkcja zwraca informacje o statusach dla wszystkich adresów które brały udział w wysyłce

mailing_info_get - Funkcja zwraca tablicę zawierająca ogólne informacje o przeprowadzonej wysyłce

mailing_info_count - Funkcja zwraca tablicę z informacjami o ilości wysłanych i zaplanowanych maili do wysłania w trakcie danej wysyłki

mailing_distribution - Funkcja zwraca dane dotyczące liczby wysłanych, odebranych maili oraz liczby kliknięć, wypisów i zwrotów z podanej wysyłki

mailing_clicked - informuje czy we wskazanej wysyłce dla bieżącego adresu e-mail zanotowano kliknięcie

mailing_total_clicked - zwraca liczbę klikniętych wiadomości e-mail podczas wskazanej wysyłki

mailing_opened - informuje czy we wskazanej wysyłce dla bieżącego adresu e-mail zanotowano otwarcie maila

mailing_total_opened - zwraca liczbę otwartych wiadomości e-mail podczas wskazanej wysyłki

mailing_bounced - informuje czy we wskazanej wysyłce dla bieżącego adresu e-mail zanotowano zwrot

mailing_bounced_status - zwraca kod “zwrotki” jaki zanotowano we wskazanych wysyłkach dla bieżącego adresu e-mail

mailing_total_bounced - zwraca dane o ilości zwrotów dla wybranych wysyłek

mailing_sent - informuje czy podczas wskazanej wysyłki został wysłany e-mail dla bieżącego adresu e-mail

mailing_total_sent - zwraca liczbę wysłanych wiadomości e-mail podczas wskazanej wysyłki

mailing_sent_count - zwraca liczbę wysłanych e-mail na bieżący adres e-mail w określonym czasie

mailing_send - Funkcja przeprowadza wysyłkę mailigu

mailing_send_test - Funkcja przeprowadza wysyłkę testową na adres $email_testowy

mailing_comment_set - Funkcja zapisuje podaną treść jako komentarz dla danej wysyłki

mailing_comment_get - Funkcja pobiera komentarz zapisany dla danej wysyłki

mailing_comment_append - Funkcja dodaje podaną treść do istniejącego komentarza dla danej wysyłki

mailing_clicked_link - informuje czy we wskazanej wysyłce dla wskazanego linka, dla bieżącego adresu e-mail zanotowano kliknięcie

mailing_total_ctr - zwraca wskaźnik CTR dla wskazanej wysyłki

mailing_total_openrate - zwraca wskaźnik openrate dla wskazanej wysyłki

mailing_total_opted_out - zwraca ilość adresów które wypisały się podczas wybranych wysyłek

mailing_tags_clicked - zwraca tablice z listą wszystkich tagów w mailingu oraz informacją, czy został kliknięty konkretny tag w linku przez konkretny adres email

mailing_agent - zwraca dane dotyczące liczby otwarć, kliknięć przez poszczególne przeglądarki, systemy operacyjne dla wysyłki

mailing_geoip - zwraca dane dotyczące geolokalizacja otwarć, kliknięć mailingu dla wysyłki

mailing_links - zwraca informacje o linkach użytych w kreacjach wysłanych w podanych wysyłkach

mailing_open_reach - zwraca wskaźnik (liczba od 0 do 1) otwarć do doręczonych mail z wybranych wysyłek

mailing_tags - zwraca dane dotyczące tagów w linkach powiązanych z liczbą kliknięć we wszystkie linki mające ten sam tag

mailing_domains - zwraca dane dotyczące domyślnie liczby wysłanych, zwrotów, otwarć,kliknięć i wypisań z poszczególnych domen dla wysyłki

mailings_id - zwraca numery wysyłek z podanego zakresu czasu

t_mailings_id - zwraca numery wysyłek maili transakcyjnych z podanego zakresu czasu

t_mailing_info_get - zwraca tablicę zawierająca ogólne informacje o przeprowadzonej wysyłce transakcyjnej

mailing_timeline_clicked_day - zwraca dane o ilości kliknięć w określonych dniach dla wybranych wysyłek

mailing_timeline_clicked_hour - zwraca dane o ilości kliknięć w określonych godzinach dla wybranych wysyłek

mailing_timeline_opened_day - zwraca dane o ilości otwarć w określonych dniach dla wybranych wysyłek

mailing_timeline_clicked_week - zwraca dane o ilości kliknięć w określonych dniach tygodnia dla wybranych wysyłek

mailing_timeline_opened_hour - zwraca dane o ilości kliknięć w określonych godzinach dla wybranych wysyłek

mailing_timeline_opened_week - zwraca dane o ilości otwarć w określonych dniach tygodnia dla wybranych wysyłek

Sms

sms_received - informuje czy podczas wskazanej wysyłki SMS, dla bieżącego adresu e-mail, zanotowano odebranie SMSa

sms_sent - informuje czy podczas wskazanej wysyłki SMS, dla bieżącego adresu e-mail, wysłano SMSa

sms_send - Funkcja przeprowadza wysyłkę SMS

sms_info_get - Funkcja zwraca tablicę zawierająca ogólne informacje o przeprowadzonej (lub zaplanowanej) wysyłce

sms_info_count - Funkcja zwraca tablicę z informacjami o ilości wysłanych i zaplanowanych smsów do wysłania

sms_campaign_name - Funkcja zwraca nazwę kampanii na podstawie podanego parametru

sms_allowed_senders - Funkcja zwraca listę wszystkich dodanych nadpisów nadawców sms, których można użyć w wiadomościach pro

Grupy

sare_groups - zwraca tablicę zawierającą numery grup do których należy bieżący adres e-mail

sare_in_group - zwraca informację, czy bieżący adres e-mail należy do wskazanej grupy

sare_group_add - Funkcja dodaje bieżący adres do grupy.

sare_group_remove - Funkcja usuwa bieżący adres z grupy.

sare_group_copy - kopiuje adresy z grupy X do grupy Y

sare_group_info - zwraca tablicę zawierającą informacje o grupie

Specjalne (systemowe)

system_setfrom - ustawia pole From podczas wysyłki newslettera

system_skipmessage - pomija wysyłkę newslettera na bieżący adres

system_setsubject - ustawia pole Subject podczas wysyłki newslettera

sare_property - zwraca tablicę cech stworzonych w systemie wraz z informacją o ich właściwościach

Dodatkowe

find_by_gsm - adresy z bazy które posiadają podany numer telefonu

get_request - zwraca parametry przekazane jako żądanie HTTP

get_request_agent - zwraca dane o przeglądarce, systemie operacyjnym użytkownika oraz urządzeniu

get_request_ip - zwraca adres IP urządzenia użytkownika

pl_imiewolacz - zwraca formę wołaczową przekazanego imienia

pl_kody - oblicza odległość pomiędzy dwoma miejscowościami na podstawie kodów pocztowych

pl_slownie - przetwarza liczbę na zapis słowny

redirect - ustawia przekierowanie na podany url

zipcode_info_get - Funkcja zwraca tablicę z informacjami na temat miasta oraz województwa na podstawie podanego kodu pocztowego

zipcode_distance - Funkcja oblicza odległość pomiędzy kodem/kodami pocztowymi

survey_report_get - zwraca raport z ankiety o identyfikatorze $surveyId w formacie csv

ss_cyclic_change_time - Funkcja przestawia czas wykonania SAREscript cyklicznego

sms_cyclic_change_time - Funkcja przestawia czas wysyłania wysyłki SMS cyklicznej

mailing_cyclic_change_time - Funkcja przestawia czas wysyłania wysyłki mailowej cyklicznej

remove_email - Funkcja usuwa z bazy podany adres email