Függvények: ügyfelek lekérdezése

Egyedi kódhoz tartozó függvények, ezért a bevezetésükhöz érdemes fejlesztő segítségét kérni.

rcp_get_customer_by_user_id()

Egy WordPress-felhasználó ügyfélrekordját adja vissza.

• $user_id (egész): a felhasználó azonosítója. A 0 a bejelentkezett felhasználót jelenti.

Visszatérési érték: RCP_Customer objektum, vagy false, ha nincs ilyen ügyfél.

$customer = rcp_get_customer_by_user_id( get_current_user_id() );

rcp_get_customer_membership_level_ids()

Lekéri az ügyfél active vagy cancelled állapotú tagságait, és visszaadja a hozzájuk tartozó tagsági szintek azonosítóit.

• $customer_id (egész): az ellenőrzött ügyfél azonosítója. Ha kimarad, a bejelentkezett ügyfelet használja.

Visszatérési érték: a tagsági szintek azonosítóinak tömbje.

Annak ellenőrzése, hogy az aktuális ügyfélnek van-e 2-es szintű tagsága:

<?php if ( in_array( 2, rcp_get_customer_membership_level_ids() ) ) : ?>
  <p>Ez a rész csak a 2-es szintű tagoknak látszik.</p>
<?php endif; ?>

rcp_get_customer_membership_level_names()

Ugyanúgy működik, mint az előző, de a szintek azonosítói helyett a nevüket adja vissza. Az ügyfél active vagy cancelled állapotú tagságait veszi figyelembe.

• $customer_id (egész): az ellenőrzött ügyfél azonosítója. Ha kimarad, a bejelentkezett ügyfelet használja.

Visszatérési érték: a tagsági szintek neveinek tömbje.

rcp_get_customers()

Ügyfelek lekérdezése szűrőkkel. Az $args tömb minden eleme elhagyható.

Kulcs	Jelentés
id	Csak ezt az azonosítójú ügyfelet adja vissza.
id__in	Ügyfélazonosítók tömbje.
id__not_in	Kihagyandó ügyfélazonosítók tömbje.
user_id	Felhasználóazonosító szerinti szűrés.
user_id__in	Felhasználóazonosítók tömbje.
user_id__not_in	Kihagyandó felhasználóazonosítók tömbje.
email_verification	E-mail-megerősítés állapota: verified, pending vagy none.
date_registered_query	A regisztráció ideje szerinti szűrés (WP_Date_Query formátum).
last_login_query	Az utolsó belépés ideje szerinti szűrés (WP_Date_Query formátum).
count	true: az ügyfelek számát adja, false: objektumok tömbjét. Alapérték: false.
fields	A visszaadott mező (bármelyik oszlopnév). Üresen teljes ügyfélobjektumokat ad.
number	Legfeljebb ennyi találat. Alapérték: 20.
offset	Kihagyott találatok száma. Alapérték: 0.
no_found_rows	Kikapcsolja a SQL_CALC_FOUND_ROWS lekérdezést. Alapérték: true.
orderby	Rendezés: id, date_registered, last_login. A false, az üres tömb vagy a none kikapcsolja a rendezést. Alapérték: id.
order	ASC vagy DESC. Alapérték: DESC.
search	Keresőszó, az ügyfél legtöbb oszlopában keres.
update_cache	Előtölti a gyorsítótárat a talált ügyfelekhez. Alapérték: false.

Visszatérési érték: alapesetben RCP_Customer objektumok tömbje. count => true esetén egész szám, fields megadásakor (például id) az adott mező értékeinek tömbje.

Az 5, 73, 41 és 104 azonosítójú felhasználók ügyfelei:

$customers = rcp_get_customers( array(
  'user_id__in' => array( 5, 73, 41, 104 ),
) );

Az e-mail-megerősítésre váró ügyfelek azonosítói:

$customer_ids = rcp_get_customers( array(
  'email_verification' => 'pending',
  'fields'             => 'id',
) );