ClientConfig setting not working in weblinks

snowcreative · February 19, 2026, 9:46pm

I’m pretty sure this used to work when the site was in 2.8, now in 3.2.0 I have a field in ClientConfig containing a global URL. When I put that in a weblink, though, I get this error:

The weblink content “[[++client_donate_url]]” provided in Resource id 5936 is invalid.

Shouldn’t this work? If not, is there a way around it?

halftrainedharry · February 20, 2026, 4:15pm

As far as I can tell, this should only affect the Preview of the weblink (button “View” in the manager). I think the weblink itself should still work.

With MODX version 3.2.0, some validity checks got added to weblink-resources. These might be too restrictive.

See this pull request for more information about the change:

github.com/modxcms/revolution

Fix Resource Preview Functionality

3.x ← smg6511:3.x-issue-16195

opened 03:07PM - 29 Sep 25 UTC

smg6511

+1526 -1267

### What does it do? - Updates processors and frontend js to properly set the… state and visibility of the preview ("View") button (in the Resource panel UI) and Resource tree contextual menus. - Adds new logic to determine validity of web and sym link content to more reliably build the correct (or empty) preview URL. - Fixes the logic setting a Resource's deleted state in the UI (changing via the tree and/or panel button was not setting the switch in the settings area). ### Why is it needed? Primarily, as noted in the issue solved, weblink URLs were not being built because the target Resource's URL was not being parsed/built. Also, discovered along the way of fixing this, the view button/tree item was not always showing/hiding/being disabled as expected. Lastly, one could pass obviously malformed content for weblinks resulting in bad links and previews. ### How to test - Create various Resource types and toggle their deleted setting (from both the panel UI and tree), noting that this action should affect the "View" button states and tree menu items as expected (a deleted Resource should hide its View option). - Create valid web and sym links and verify that the correct document is shown when clicking "View" - Create invalid weblinks in various ways and verify the "View" button is disabled and the tree menu item is hidden. ### Note I made the choice to disable instead of hide the View button for invalid web/symlinks, in contrast to how it's hidden for deleted Resources. I'm of the mind that action buttons/links shouldn't be hidden at all, just disabled. (It seems somewhat jarring for items to appear and disappear from the main UI.) This would be similar to the common pattern of showing, say, a Submit or Save button in a disabled state until the form it relates to is completely filled out. Let me know your thoughts on this, as I'd move to make a few more changes to make this behavior consistent. ### Related issue(s)/PR(s) Resolves #16195

snowcreative · February 21, 2026, 8:33pm

Actually, that isn’t even working properly. If the URL entered into the client_donate_url field in Clientconfig is “https://externalwebsite.xyz”, and the weblink is set to [[++client_donate_url]], then the link that shows up in the site menu is “https://mywebsite.com/https://externalwebsite.xyz”. The site_url is getting prepended to the weblink, which shouldn’t happen. (use_weblink_target is set to “yes”.)

halftrainedharry · February 21, 2026, 10:08pm

I tried to reproduce this issue, but wasn’t able to.

On a fresh installation of MODX 3.2.0-pl with ClientConfig 2.5.0-pl (and “use_weblink_target” = Yes) I created a new weblink with [[++client_donate_url]] as the value.
When I use a link tag ([[~...]]) to this weblink on another page, I get the correct output → https://externalwebsite.xyz.

How do you generate the site menu?

snowcreative · February 21, 2026, 10:25pm

Yes, links embedded in pages work. But weblinks in the menus did not.

The custom script that creates the menus was looking for a class_key value of “modWebLink“ to do something specific with those. In MODX 3, the value is “MODX\Revolution\modWebLink”. I updated the script, and the menus are correct now.