About admin notifications

[adriendupuis]

Question	Answer
JIRA Ticket
Versions
Edition

Inspired by ibexa/recipes-dev#257

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[github-actions]

Preview of modified files

Preview of modified Markdown:

• docs/api/notification_channels.md

[github-actions]

Summary

Status	Count
🔍 Total	750726
🔗 Unique	15057
✅ Successful	6307
⏳ Timeouts	0
🔀 Redirected	0
👻 Excluded	744419
❓ Unknown	0
🚫 Errors	0
⛔ Unsupported	0

Full Github Actions output

[mnocon]

Do you think it makes sense to explain the difference between Ibexa\AdminUi\Notifier\Notification\UserInvitation and Ibexa\Contracts\User\Notification\UserInvitation ?

Some kind of table where the action triggering the notification is described?

( understand this could be a follow-up)

[adriendupuis]

@mnocon
Yes, it would. While adding 451caef I was also thinking at a kind of table that would describe purpose, default recipients, maybe the actual notifier service when it exists (TriggerNotificationsSubscribers, …\PasswordReset\Notifier, etc.)

[adriendupuis]

I could expose the default result. --json | jq is optional, it rturn unformmated but readable JSON by default. I don't know what to do with FormSubmitted from ibexa/recipes-dev#257
It seems not immediately needed but it could be needed in the rare case someone use the form builder for an admin form.

Suggested change

	```bash
	php bin/console ibexa:debug:config notifications.subscriptions --siteaccess=admin
	```
	```bash
	php bin/console ibexa:debug:config notifications.subscriptions --siteaccess=admin --json | jq
	```
	```json
	{
	"ibexa_content_edit_invitation": {
	"channels": [
	"ibexa",
	"email"
	]
	},
	"ibexa_content_view_invitation": {
	"channels": [
	"ibexa",
	"email"
	]
	},
	"ibexa_external_participant_content_view_invitation": {
	"channels": [
	"email"
	]
	},
	"Ibexa\\AdminUi\\Notifier\\Notification\\UserPasswordReset": {
	"channels": [
	"email"
	]
	},
	"Ibexa\\AdminUi\\Notifier\\Notification\\UserInvitation": {
	"channels": [
	"email"
	]
	},
	"Ibexa\\Contracts\\FormBuilder\\Notifications\\FormSubmitted": {
	"channels": [
	"email"
	]
	}
	}
	```