KT WP User Base Model

V rámci této báze pro entitu vycházející z registrovaného uživatele, je připraven model, který udržuje základní data a informace právě o daném uživateli. Model nabízí sadu funkcí pro nejčastější činnost s daty. Model je možné použít samostatně s možnosti inicializace (nejedná se o abstraktní třídu) nebo lze dědit jeho vlastnosti pro Vámi definované a složitější modely.

Umístění modelu: kt/core/models/kt_wp_user_base_model.inc.php

Některé metody jsou osazeny “lazyLoadingem“. Data nejsou do modelu nahrána dříve, než jsou poprvé vyžádána.

Inicializace modelu

__construct($userId = null)

Pro inicializaci objektu musíme zadat ID uživatele, s jehož daty chceme v rámci modelu aktivně pracovat. Pokud ID nezadáme, je potřeba načíst data dodatečně pomocí další funkce. V opačném případě nebude model vracet žádné data.

$model = new KT_WP_User_Base_Model(1);

1	$model = new KT_WP_User_Base_Model(1);

Sada Getterů

getWpUser()

Vrátí objekt WP_User, který je defaultně vytvářen WordPressem. Máte tak možnost se dostat na informace, které jsou v rámci tohoto objektu dostupné.

echo $model->getWpUser()->email;
echo $model->getWpUser()->display_name;
...

echo $model->getWpUser()->email;

echo $model->getWpUser()->display_name;

...

getWpUserMetas()

Vrátí pole se všemi údaji, které jsou uloženy v tabulce wp_usermetas a patří k danému uživateli, který byl vyvolán při inicializace objektu. Metoda je osazena lazyLoadingem.

$userMetas = $model->getUserMetas();
echo $userMetas["first_name"]; // Jméno
echo $userMetas["last_name"]; // Příjmení
atd...

$userMetas = $model->getUserMetas();

echo $userMetas["first_name"]; // Jméno

echo $userMetas["last_name"]; // Příjmení

atd...

Obecné funkce, pro práci s modelem

getId()

Vrátí ID uživatele, které bylo použito při inicializaci modelu.

$userId = $model->getId();

1	$userId = $model->getId();

getNiceName()

Vrátí nickname uživatele, které si v rámci svého profilu nastavil.

echo "Přezdívka: " . $model->getNiceName();

1	echo "Přezdívka: " . $model->getNiceName();

getWebUrl()

Vrátí url adresu webu, kterou si uživatel nastavil ve svém profilu.

echo "Autor článku: <a href=\"". $model->getWebUrl() ."\">". $model->getNiceName() ."</a>";

1	echo "Autor článku: <a href=\"". $model->getWebUrl() ."\">". $model->getNiceName() ."</a>";

getDisplayName()

Vrátí jméno, kterým chce být uživatel zobrazován a nastavil si ho tak v profilu.

echo "Jméno autora: " . $model->getDisplayName();

1	echo "Jméno autora: " . $model->getDisplayName();

getEmail()

Vrátí email uživatele, který vyplnil při registraci.

echo "Email autora: " . $model->getEmail();

1	echo "Email autora: " . $model->getEmail();

getFirstName()

Vrátí jméno uživatele.

echo "Jméno: " . $model->getFirstName();

1	echo "Jméno: " . $model->getFirstName();

getLastName()

Vrátí příjmení uživatele.

echo "Příjmení: " $model->getLastName();

1	echo "Příjmení: " $model->getLastName();

getFullName()

Vrátí kombinace Jména a příjmení pro prezentaci celého jména uživatele.

echo "Celé jméno autora: " . $model->getFullName();

1	echo "Celé jméno autora: " . $model->getFullName();

getPhone()

Pokud používáte rozšíření uživatele v rámci frameworku, uživatel má možnost zadat v profilu také svůj telefon. Toto nastavení lze aplikovat v configurátoru.

"Telefon: " . $model->getPhone();

1	"Telefon: " . $model->getPhone();

getAvatar()

Vrátí avatar uživatele.

getPermalink()

Vrátí URL adresu na detail autorovo archivu. Tato sekce je zastoupena šablonou v souboru author.php

echo "<a href=\"". $model->getPermalink() ."\">O Autorovi</a>";

1	echo "<a href=\"". $model->getPermalink() ."\">O Autorovi</a>";

getUserPostCount($postType, $postStatus)

Vrátí počet příspěvků autora na základě předaných parametrů.

$postType = „post“ – defaultně
$postStatus = „publish“ – defaultně

echo "Autor již publikoval: " . $model->getUserPostCount() . " příspěvků";

1	echo "Autor již publikoval: " . $model->getUserPostCount() . " příspěvků";

getQueryWithUserPosts($postType, $postStatus)

Vrátí objekt WP_Query se všemi příspěvky na základě předaných parametrů.

$postType = „post“ – defaultně
$postStatus = „publish“ – defaultně

canUser()

Prověří, zda uživatel může nebo nemůže provádět změny v příslušné „capability“ nebo roleName.

if($model->canUser("manage_categories")){
     // Uživatel může editovat kategorie příspěvků
}
...

if($model->canUser("manage_categories")){

// Uživatel může editovat kategorie příspěvků

}

...

wpUserInitByPostAuthor(WP_Post $post)

Načte data uživatele na základě příspěvku a jeho přiřazeného autora.

$model = new KT_WP_User_Base_Model();
$model->wpUserInitByPostAuthor($post);
...

$model = new KT_WP_User_Base_Model();

$model->wpUserInitByPostAuthor($post);

...

getMetaValueByKey($metaKey)

Vrátí jednu hodnotu z wp_usermetas na základě zadaného klíče

echo "User meta hodnota: " . $model->getMetaValueByKey("klic-hodnoty-wp-usermetas");

1	echo "User meta hodnota: " . $model->getMetaValueByKey("klic-hodnoty-wp-usermetas");

Statické metody

getAllUserMeta($userId, $prefix = null)

Vrátí všechny user metas k danému uživateli – v případě volby prefixu probíhá LIKE dotaz pouze na ty klíče, které začínají zadaným prefixem.

$addressData = KT_WP_User_Base_Model::getAllUserMeta(1, "kt-user-address");
echo $addressData["kt-user-address-street];
echo $addresData["kt-user-address-city];
...

$addressData = KT_WP_User_Base_Model::getAllUserMeta(1, "kt-user-address");

echo $addressData["kt-user-address-street];

echo $addresData["kt-user-address-city];

...