Capable Search integration
Two sort options (Git Last Updated, Git File Count), four grid columns (Files, Repositories, Organizations, File Types), four filters (Minimum Files, Repository, Organization, File Type), a "Github" page panel subtitled "Github files referenced on this page", and four natural-language query suggestions.
#Worth knowing
The grid column labels and the CQL field names differ: the grid says "Files" where the sort menu and CQL say "Git File Count". The search panel deep-links to help at 'confluence-git'.
#Where you do it
Task | Where |
|---|---|
Connect your GitHub account | On a Confluence page: insert the "Github file (Capable)" macro, then press Connect GitHub in the macro; or open the macro's configuration and press Connect in the Browse GitHub modal. |
Add a file from a repository to a page | Macro configuration → Browse GitHub modal |
Connect a second GitHub account (for example work and | Browse GitHub modal → account dropdown → "Add account", or the Manage Connections panel reached from the picker's toolbar |
#Settings that affect this
Setting | Where | What it does |
|---|---|---|
There is no GitHub settings screen | Nowhere | The git capability declares no global settings tab and no space settings tab, so GitHub contributes nothing to Capable global settings or space settings. There is also no admin "connect the site to GitHub" screen, becaus |
Hide GitHub across the whole site | App property `capable-global-hidden-capabilities`, object name `hiddenCapabilities`, value | Hides the capability tenant-wide. IMPORTANT: this gates the BYLINE ONLY. The macro module has no display conditions, so hiding the capability does not stop existing GitHub macros from rendering on pages. |
Turn GitHub on or off per space | Space property `<APP_HASH>_capable`, object name `capabilities.alwaysOff` / `capabilities. | AlwaysOff suppresses the byline in that space; alwaysOn shows it even on pages with no GitHub macro. Again, byline only. Macros still render. |
#Related
How it actually behaves.
