print-advanced-widget

Repository for the Print Advanced custom widget for ArcGIS Experience Builder Developer Edition (1.19 to 1.21, React 19).

Print Advanced reproduces an ArcGIS Pro layout (.pagx) in the browser and exports it with no print service required. An optional Esri print service path is included for server side layouts. For the full feature list and install steps, see the widget README in the print-advanced subfolder.

Author: Brian McLeer, City of Grand Junction, CO.

Default logo: embed or link

Version 1.15.0 adds an optional logo URL. Embedding remains the default; URL mode stores only the link and downloads the image when an export needs it. Switching to URL mode clears the embedded logo. Save and republish to reduce app config size. The live preview shows a placeholder for linked logos. See logo setup and CORS requirements.

Esri Community

Post and discussion: https://community.esri.com/t5/experience-builder-custom-widgets/print-advanced-beta-use-arcgis-pro-pagx-layout/ba-p/1712031

Repository layout

print-advanced-widget/            <- this repo
├── README.md                     <- this file (GitHub landing page)
├── LICENSE                       <- Apache-2.0
├── .gitignore                    <- ignores node_modules, .vs, dist, OS cruft
├── publish.ps1                   <- one-command publish/update script
└── print-advanced/               <- the widget (drops into your-extensions/widgets)
    ├── package.json
    ├── package-lock.json
    ├── manifest.json
    ├── config.json
    ├── icon.svg
    ├── README.md                 <- install steps, features, troubleshooting
    ├── LICENSE
    ├── .gitignore
    ├── .npmignore
    └── src/ ...

The widget lives in the print-advanced subfolder so this repo can hold project level files without polluting the shareable widget. Only the print-advanced folder is dropped into an Experience Builder install.

Install (for users)

See print-advanced/README.md for the full steps. In short: place the print-advanced folder in client\your-extensions\widgets\, install dependencies from the client folder (npm install on 1.19/1.20, pnpm install on 1.21+), then restart.

The release zip and the editor shims

The zip is the widget only. The Visual Studio type shims in the repo (print-advanced/src/exb-editor-shims-print-advanced.d.ts, print-advanced/src/exb-editor-shims.d.ts) are left out on purpose: their ambient declare module blocks are not file-scoped and would rewrite the react, jimu and esri types for every other widget in your your-extensions folder.

If you clone the repository instead of using the zip, delete print-advanced/src/exb-editor-shims-print-advanced.d.ts and the other shim files listed above before building; nothing else depends on them.

Publishing updates (for the maintainer)

publish.ps1 syncs the widget from the live Experience Builder folder into this repo's print-advanced subfolder (skipping node_modules and .vs), commits, pushes to GitHub, and optionally cuts a release. Edit the three variables at the top of the script if paths change.

• Code update only:

  powershell -ExecutionPolicy Bypass -File .\publish.ps1
  

• Code update plus a new downloadable version:

  powershell -ExecutionPolicy Bypass -File .\publish.ps1 -Release v1.0.0
  

Version tags must increase and never repeat. Bug fix: v1.0.1. New feature: v1.1.0. Major change: v2.0.0.

For the Esri Community attachment, download the ZIP from the GitHub release produced by publish.ps1. This keeps it in sync with GitHub and excludes editor shims, localization metadata, dependency folders and scratch files.

Contributors

• Brian McLeer, City of Grand Junction, CO (author, maintainer)
• Nicholas Cramer, Polk County, OR (contributor)

Languages

The widget follows the Experience Builder app language: the ArcGIS profile language, the browser, ?locale=xx in the URL, or the Language Switcher widget. Interface text lives in src/runtime/translations/default.ts (and src/setting/translations/default.ts for the settings panel), with language files for all 39 Experience Builder locales made by exb-i18n-kit.

• Esri's own Experience Builder translations are used first, so shared words match the out-of-the-box widgets.
• Other strings come from the kit's shared translation memory. Machine translations are marked for review.
• Anything not translated yet shows in English.
• Coverage per language: print-advanced/i18n/STATUS.md.
• To fix a translation for every widget that uses it, open a pull request on memory/<locale>.json in exb-i18n-kit.

License

Apache-2.0. See the LICENSE file.