Sites
The Sites screen lists every site you have connected, and is where you add, edit, remove or visit one. If you have never connected a site, this is the first thing you see when Grafida opens.
The site list
Each row shows the site's favicon (once Grafida has found one), its title and its address. Tapping a row opens it for editing. Swipe, or press and hold, for:
- Edit
- Delete — removes the site, its cached data and its stored token. It does not delete anything from the site itself, or any local drafts you already exported.
- Reload metadata — re-fetches this site's categories, tags, access levels, languages and custom fields, and re-checks its favicon. Grafida caches all of this so that opening an article is fast; use this after you change something on the site itself (a new category, a renamed tag) that you want to see reflected immediately. See Settings for how often this happens automatically, and where that option lives.
- Visit site — opens the site's own front end inside Grafida, without leaving the app.
The ⋯ button in the top right holds two app-wide items: App Lock, which can require Face ID, Touch ID or your passcode before Grafida — or a particular site — will open (see App Lock), and Reset local storage, which erases everything Grafida has stored on this device — see Settings for what that covers and the two confirmations it asks for first.
A site protected by App Lock shows a small padlock beside its name in the list.
Adding or editing a site
| Field | What it does |
|---|---|
| Title | The label shown everywhere in Grafida. Purely local — never sent to the site. |
| URL | The site's base address. See Connect a Site for what to include and what to leave out. |
| API Token | Your personal Joomla API token. On an existing site this field is always shown blank — Grafida never displays a stored token back to you — so leave it blank to keep what is already saved, or paste a new one to replace it. |
| Editor CSS URL | Optional. Leave it blank unless the article text in Grafida looks visibly different from how it renders on your site — see the note below. |
| Media filesystem | Which of the site's Media Manager filesystems new uploads go to. "Automatic" uses the site's own default (usually images). |
| Media upload folder | A folder created inside that filesystem for anything Grafida uploads, so your uploads stay easy to find. Defaults to grafida if left blank. |
| Unicode Aliases | See below. |
Test Connection checks the URL and token without saving anything, and reports one of: success (with the API address it found), a rejected token, or a connection problem — see Connection Troubleshooting for what each means.
Editor CSS URL
Joomla can style the editor's text area to look like the site's own template, using a stylesheet
usually called editor.css. Grafida looks for this automatically. If it cannot find it — commonly
because your account cannot read the site's template settings, or the site uses a non-standard
path — set the relative path here, e.g. media/templates/site/mytemplate/css/editor.css.
Unicode Aliases
An article's alias (the last part of its URL) is normally restricted to Latin letters, digits and dashes, with everything else transliterated to the nearest match. Joomla's Unicode Aliases setting, in Global Configuration, can turn that restriction off so titles in Greek, Cyrillic, CJK and other scripts keep their own characters instead.
Reading that setting needs a Super User's token, so if you connected with a lesser account, Grafida cannot ask and assumes "off" — correct for most sites, wrong if yours has it on. Set this field to Yes or No to tell Grafida directly, or leave it on Automatic to let a Super User's token keep answering for itself.
Where your token is kept
Your API token is stored in the device's own Keychain, not in Grafida's database. If the app's database ever left your device — a backup, an exported file — it would not carry your token with it. It does not protect you from something already running on your own, unlocked device as you — nor from somebody holding that unlocked device, which is what App Lock is for.