Hi,
I'm trying to get some basic knowledge of Processwire module development. I've read the beginner guides and I've done a lot of research.
My current use case is to extend a custom admin template for pages with an update button in the "settings" tab of this template. The update button should then update the page's data through an external API on this page using its metadata that this template type has when you edit the page in the admin.
Here's the shortened PHP code (yes, I've build own classes for the hooks) of what I trying to achieve that comes along with a few problems:
<?php
namespace ProcessWire;
class TestUpdate extends Process implements ConfigurableModule
{
public const XHR_PAGE_NAME = 'test-update';
public const JSON_TPL_NAME = 'json';
public static function getModuleInfo()
{
return [
'title' => 'My Admin Extender',
'summary' => 'An admin module to easily bring test data up-to-date',
'version' => '0.0.1',
'permission' => 'test-update',
'permissions' => [
'test-update' => 'View the button in the template',
'test-update-save' => 'Permission to perform the actual update from API',
],
'icon' => 'table',
'author' => 'alpham8',
'requires' => 'UpdatePlugin>=0.0.1, ProcessWire>=3.0.133',
'page' => [
'name' => self::XHR_PAGE_NAME,
'title' => 'update-product',
'template' => 'admin'
]
];
}
public function ready()
{
/** @var Page $page */
$page = $this->wire('page');
// add helper notices about ProCache to page and template editors
if (static::isTemplate('admin', $page)) {
$this->addHookAfter('ProcessPageEdit::buildFormSettings', $this, 'hookPageEdit');
}
}
public function hookPageEdit(HookEvent $event)
{
/** @var WirePageEditor $process */
$process = $event->object;
$page = $process->getPage();
if (static::isTemplate('product', $page)) {
// TODO: maybe add $this->user->isSuperuser() check
$form = $event->return;
/** @var InputfieldMarkup $field */
$field = $this->modules->get("InputfieldMarkup");
$info = HaroImportProductPages::getModuleInfo();
$field->label = $info['title'];
$field->icon = $info['icon'];
/** @var InputfieldButton $btn */
$btn = $this->modules->get('InputfieldButton');
$btn->attr('value', 'update product data');
if ($page->hasField('param1') && $page->hasField('param2')) {
$btn->attr(
'href',
'#'
);
$btn->addClass('update-link');
$btn->attr('data-param1', $page->get('param1'));
$btn->attr('data-url', 'https://' . $_SERVER['HTTP_HOST'] . '/processwire/test-update/save/');
}
$btn->icon = 'refresh';
$btn->attr('id+name', 'UpdateProductPagesBtn');
$btn->label = 'Update product data';
$btn->collapsed = Inputfield::collapsedNever;
$field->collapsed = Inputfield::collapsedNever;
$field->attr('value', $btn->render());
$form->add($field);
}
}
/**
* Does user have permission?
*
* @param string $name
* @return bool
* @throws WireException
*/
protected function hasPermission(string $name): bool
{
$user = $this->wire()->user;
if ($user->isSuperuser()) {
return true;
}
return $user->hasPermission($name);
}
public function execute(): array|string
{
return 'test1';
}
public function executeSave(): array|string
{
$input = $this->wire()->input;
$testparam = $input->post('testparam');
$result = false;
/** @var UpdatePlugin $module */
$module = $this->wire->modules->get('UpdatePlugin');
// possibly product number check:
if ($testparam !== '' && is_numeric($testparam) && \mb_strlen($testparam, 'UTF-8') >= 4) {
$result = $module->writeDataToPage($testparam);
}
return json_encode([
'testparam' => $testparam,
'success' => $result === 1,
]);
}
}
My problems or questions are:
1st The ready method doesn't get called in an admin module, instead, I need to place it in another module like this:
<?php
namespace ProcessWire;
class UpdatePlugin extends Wire implements Module
{
public static function getModuleInfo()
{
return [
'title' => 'UpdatePlugin',
'version' => '0.0.1',
'summary' => 'Summary for UpdatePlugin ...',
'author' => 'alpham8',
'icon' => 'table',
'autoload' => true,
'requires' => 'ProcessWire>=3.0.123',
];
}
public function init()
{
$scriptUrl = $this->urls->$this . 'assets/product-update.js';
$this->config->scripts->add($scriptUrl);
}
public function ready()
{
/** @var Page $page */
$page = $this->wire('page');
// add helper notices about ProCache to page and template editors
if (static::isTemplate('admin', $page)) {
$this->addHookAfter('ProcessPageEdit::buildFormSettings', $this, 'hookPageEdit');
}
}
// [see above] ...
}
2nd Isn't there a way to just build an ajax request that returns plain JSON without that page / template skeleton? As far as I understood it, a page is mandatory in Processwire for this. That would be fine, if we can hide the page in the admin's navbar by using css. I thought that might be possible with creating an own template that just outputs JSON, right? But how to do a template without a parent one?
3rd How can I bring or access variables from modules in pages? Just by calling it without the knowledge that they are exist on the concrete (PHP) page?
4th Isn't there a way to get the absolute URL out of $config->urls ? I'd like to avoid that insecure $_SERVER['HTTP_HOST'] call.
We're currently on ProcessWire 3.0.210. An update is planned after that modules.
Any help to that above question would be great.
Thanks in advice,
alpham8
