PageQueryBoss
Bugfix Release 0.0.6
Crie consultas aninhadas complexas contendo vários campos e páginas e retorne uma matriz que pode ser analisada em JSON. Isso é útil para buscar dados para SPA e PWA.
Você pode usar o módulo para transformar uma página ProcessWire ou PageArray – até mesmo RepeaterMatrixPageArrays – em um array ou JSON. As consultas podem ser aninhadas e conter encerramentos como funções de retorno de chamada. Alguns tipos de campos são transformados automaticamente, como Pageimages ou MapMarker.
Confira a página de lançamentos e assine as atualizações.
Recomenda-se instalar através do administrador do ProcessWire " Módulos " > " Site " > " Adicionar Novo " > " Adicionar Módulo do Diretório " usando o nome da classe PageQueryBoss .
Baixe os arquivos do Github ou do repositório ProcessWire: https://modules.processwire.com/modules/page-query-builder/
Existem dois métodos principais:
$page->pageQueryJson($query);
$page->pageQueryArray($query);
A consulta pode conter pares de chave e valor ou apenas chaves. Pode ser aninhado e conter fechamentos para valores dinâmicos. Para ilustrar um pequeno exemplo:
// simple query:
$query = [
'height',
'floors',
];
$pages->find('template=skyscraper')->pageQueryJson($query);
As consultas podem ser aninhadas, conter nomes de páginas, nomes de modelos ou conter funções e seletores ProcessWire:
// simple query:
$query = [
'height',
'floors',
'images', // < some fileds contain default sub-queries to return data
'files' => [ // but you can also overrdide these defaults:
'filename'
'ext',
'url',
],
// Assuming there are child pages with the architec template, or a
// field name with a page relation to architects
'architect' => [ // sub-query
'name',
'email'
],
// queries can contain closure functions
'querytime' => function($parent){
return "Query for $parent->title was built ".time();
}
];
$pages->find('template=skyscraper')->pageQueryJson($query);
Um único nome de campo ; height ou floors ou architects
O Módulo pode lidar com os seguintes campos:
Um nome de modelo ; skyscraper ou city
Nome de uma página filha (page.child.name=pagename); my-page-name
Um seletor ProcessWire ; template=building, floors>=25
Um novo nome para o índice retornado passado por um delimitador # :
// the field skyscraper will be renamed to "building":
$query = ["skyscraper`#building`"]
Qualquer uma das chaves acima (1-5) com uma nova matriz de subconsulta aninhada:
$query = [
'skyscraper' => [
'height',
'floors'
],
'architect' => [
'title',
'email'
],
]
Uma chave nomeada e uma função de fechamento para processar e retornar uma consulta. O encerramento obtém o objeto pai como argumento:
$query = [
'architecs' => function($parent)
{
$architects = $parent->find('template=architect');
return $architects->arrayQuery(['name', 'email']);
// or return $architects->explode('name, email');
}
]
$query = [
'title',
'subtitle',
// naming the key invitation
'template=Invitation, limit=1#invitation' => [
'title',
'subtitle',
'body',
],
// returns global speakers and local ones...
'speakers' => function($page){
$speakers = $page->speaker_relation;
$speakers = $speakers->prepend(wire('pages')->find('template=Speaker, global=1, sort=-id'));
// build a query of the speakers with
return $speakers->arrayQuery([
'title#name', // rename title field to name
'subtitle#ministry', // rename subtitle field to ministry
'links' => [
'linklabel#label', // rename linklabel field to minlabelistry
'link'
],
]);
},
// Child Pages with template=Program
'Program' => [
'title',
'summary',
'start' => function($parent){ // calculate the startdate from timetables
return $parent->children->first->date;
},
'end' => function($parent){ // calculate the endate from timetables
return $parent->children->last->date;
},
'Timetable' => [
'date', // date
'timetable#entry'=> [
'time#start', // time
'time_until#end', // time
'subtitle#description', // entry title
],
],
],
// ProcessWire selector, selecting children > name result "location"
'template=Location, limit=1#location' => [
'title#city', // summary title field to city
'body',
'country',
'venue',
'summary#address', // rename summary field to address
'link#tickets', // rename ticket link
'map', // Mapmarker field, automatically transformed
'images',
'infos#categories' => [ // repeater matrix! > rename to categories
'title#name', // rename title field to name
'entries' => [ // nested repeater matrix!
'title',
'body'
]
],
],
];
if ($input->urlSegment1 === 'json') {
header('Content-type: application/json');
echo $page->pageQueryJson($query);
exit();
}
As configurações dos módulos são públicas. Eles podem ser modificados diretamente, por exemplo:
$modules->get('PageQueryBoss')->debug = true;
$modules->get('PageQueryBoss')->defaults = []; // reset all defaults
Alguns tipos de campos ou modelos vêm com seletores padrão, como Pageimages etc. Estas são as consultas padrão:
// Access and modify default queries: $modules->get('PageQueryBoss')->defaults['queries'] = …
public $defaults = [
'queries' => [
'Pageimage' => [
'basename',
'url',
'httpUrl',
'description',
'ext',
'focus',
],
'Pageimages' => [
'basename',
'url',
'httpUrl',
'description',
'ext',
'focus',
],
'Pagefile' => [
'basename',
'url',
'httpUrl',
'description',
'ext',
'filesize',
'filesizeStr',
'hash',
],
'Pagefiles' => [
'basename',
'url',
'httpUrl',
'description',
'ext',
'filesize',
'filesizeStr',
'hash',
],
'MapMarker' => [
'lat',
'lng',
'zoom',
'address',
],
'User' => [
'name',
'email',
],
],
];
Esses padrões só serão usados se não houver subconsulta aninhada para o respectivo tipo. Se você consultar um campo com dados complexos e não fornecer uma subconsulta, ele será transformado de acordo:
$page->pageQueryArry(['images']);
// returns something like this
'images' => [
'basename',
'url',
'httpUrl',
'description',
'ext',
'focus'=> [
'top',
'left',
'zoom',
'default',
'str',
]
];
Você sempre pode fornecer sua própria subconsulta, portanto os padrões não serão usados:
$page->pageQueryArry([
'images' => [
'filename',
'description'
],
]);
Você também pode substituir os padrões, por exemplo
$modules->get('PageQueryBoss')->defaults['queries']['Pageimages'] = [
'basename',
'url',
'description',
];
O índice para elementos aninhados pode ser ajustado. Isso também é feito com padrões. Existem 3 possibilidades:
Esta é a configuração padrão. Se você tiver um campo que contém subitens, o nome será a chave nos resultados:
// example
$pagesByName = [
'page-1-name' => [
'title' => "Page one title",
'name' => 'page-1-name',
],
'page-2-name' => [
'title' => "Page two title",
'name' => 'page-2-name',
]
]
Se um objeto estiver listado em $defaults['index-id'] o id será a chave nos resultados. Atualmente, nenhum item está listado como padrão para índice baseado em ID:
$modules->get('PageQueryBoss')->defaults['index-id']['Page'];
// example
$pagesById = [
123 => [
'title' => "Page one title",
'name' => 123,
],
124 => [
'title' => "Page two title",
'name' => 124,
]
]
Por padrão, alguns campos são transformados automaticamente para conter índices numerados:
// objects or template names that should use numerical indexes for children instead of names
$defaults['index-n'] => [
'skyscraper', // template name
'Pageimage',
'Pagefile',
'RepeaterMatrixPage',
];
// example
$images = [
0 => [
'filename' => "image1.jpg",
],
1 => [
'filename' => "image2.jpg",
]
]
Dica: Quando você remove a chave Pageimage de $defaults['index-n'], o índice será novamente baseado em nome.
Estas são algumas funções de fechamento do helpfill que você pode querer usar ou que podem ajudar como ponto de partida para você (informe-me se tiver a sua própria):
$query = ['languages' => function($page){
$ar = [];
$l=0;
foreach (wire('languages') as $language) {
// build the json url with segment 1
$ar[$l]['url']= $page->localHttpUrl($language).wire('input')->urlSegment1;
$ar[$l]['name'] = $language->name == 'default' ? 'en' : $language->name;
$ar[$l]['title'] = $language->getLanguageValue($language, 'title');
$ar[$l]['active'] = $language->id == wire('user')->language->id;
$l++;
}
return $ar;
}];
Usando o módulo ContinentsAndCountries você pode extrair códigos iso e nomes de países:
$query = ['country' => function($page){
$c = wire('modules')->get('ContinentsAndCountries')->findBy('countries', array('name', 'iso', 'code'),['code' =>$page->country]);
return count($c) ? (array) $c[count($c)-1] : null;
}];
Usando um RepeaterMatrix você pode criar uma string de modelo para seu frontend. Isso é útil para botões, rótulos, etc. O código a seguir usa um repetidor com o nome strings tem uma key e um campo body , a matriz retornada contém o campo key como, você adivinha, chaves e o campo body como valores:
// build custom translations
$query = ['strings' => function($page){
return array_column($page->get('strings')->each(['key', 'body']), 'body', 'key');
}];
Usando a configuração a seguir, você pode lidar com vários idiomas e retornar seu idioma padrão se o idioma solicitado não existir. O URL é composto assim: page/path/{language}/{content-type} por exemplo: api/icf/zurich/conference/2019/de/json
// get contenttype and language (or default language if not exists)
$lang = wire('languages')->get($input->urlSegment1);
if(!$lang instanceof Nullpage){
$user->language = $lang;
} else {
$lang = $user->language;
}
// contenttype segment 2 or 1 if language not present
$contenttype = $input->urlSegment2 ? $input->urlSegment2 : $input->urlSegment1;
if ($contenttype === 'json') {
header('Content-type: application/json');
echo $page->pageQueryJson($query);
exit();
}
O módulo respeita wire('config')->debug. Ele se integra ao TracyDebug. Você pode substituí-lo assim:
// turns on debug output no mather what:
$modules->get('PageQueryBoss')->debug = true;
Torne os padrões configuráveis via backend. Como isso poderia ser feito com estilo com as consultas padrão?
Consulte o arquivo LICENSE incluído para obter o texto completo da licença.
© noelboss.com
