Skip to content

Connect a Site

Grafida talks to your Joomla! site through its Web Services (REST) API. To use it, your site needs an active API token, and Grafida needs to know your site's address and that token.

1. Get a Joomla API token

  • Log into your site, and open your own user account's edit page (in the back end, the User Menu in the top right, then Edit Account; on the front end, your profile's edit page).
  • Find the Joomla API Token section.
  • Set Active to Yes and save.
  • The page shows a Token field once saved. Copy it — this is your personal API token. Treat it like a password: whoever has it can act on your site as you, and it does not expire on its own.

If you are not a Super User, ask your site's Super User to confirm your account has the core.login.api permission — see Requirements. Without it, a token from this account cannot authenticate to the API at all, whatever it shows on this page.

2. Add the site in Grafida

  • Open the Sites screen and tap Add Site.
  • Title — anything that helps you recognise it, e.g. "Company Blog".
  • URL — your site's base address, e.g. https://www.example.com. Do not include /administrator, /api, or a language code such as /en — Grafida works out the rest. It must be an HTTPS address with a certificate your device trusts; if you leave the https:// off, Grafida adds it for you. See HTTPS is required for why a plain http:// address is refused.
  • API Token — paste what you copied above.
  • Leave the other fields at their defaults for now; see Sites for what each one does.
  • Tap Test Connection. A green success message means you are ready to go — save the site.

If the test fails, Connection Troubleshooting walks through what each message means and how to fix it.

Connecting more than one site

Repeat the steps above for each additional site. Every site keeps its own token, its own cached categories and tags, and its own settings — nothing is shared between them except the app itself.