How to run some custom code on backend user login

Questions
, ,
1

Is it possible to run something immediately on backend user login? For now I’ve created a simple backofficeEntryPoint plugin that just displays an alert and writes to the browser console but nothing happens. Have I misunderstood the backofficeEntryPoint? The docs say “See Backoffice Entry Point if you are looking for an Extension that runs when the user is logged in.”

I’ve configured 2FA as per the docs and ultimately I want to display the 2FA barcode dialog if you log in and haven’t set it, but that feels a long way off at this point.

2

Yeah the backoffice entry point is exactly for what you want it to do. Let’s get the obvious out of the way:

  • Did you register it correctly in a manifest file (umbraco-package.json) and is that file somewhere in /App_Plugins/ or /wwwroot/?
  • Are you sure you cleared your browser cache? That caught me out quite a few times….
3

Yes I believe so. I’ve followed the same pattern as for other extensions I’ve created. I can see it listed in the installed packages tab after login, so Umbraco def knows about it. I’ve also cleared my cache but no luck.

4

Can you share your entry point JS/TS file and your if its possible? That’ll make it much easier to spot what’s going wrong if thats the case ,

still In the meantime, check these
your entry point file needs a named onInit export per the docs:

import type { UmbEntryPointOnInit } from '@umbraco-cms/backoffice/extension-api';

export const onInit: UmbEntryPointOnInit = (host, extensionRegistry) => {
  console.log('Entry point loaded!');
};

2. Is the JS file actually loading?
DevTools → Network tab, filter by your JS filename. A 404 means the js path in your umbraco-package.json is pointing to the wrong location.

3. Any Console errors?
A broken import or syntax error could silently prevent onInit from ever running.

4. Stale build?
If you’re using Vite or another bundler, make sure you’ve rebuilt after your latest changes the old compiled output may still be what’s being served.

5

Aha found it. In my umbraco-package.json, I had this:

"element": "/App_Plugins/Cornwall.Umbraco.EnforceTwoFactorAuth/gavtest.js"

instead of this:

"js": "/App_Plugins/Cornwall.Umbraco.EnforceTwoFactorAuth/gavtest.js"

Recompiled and now I am seeing the alert. Your suggestion of checking the network tab confirmed for me that it wasn’t loading the script at all. Thank you.

1 Like