Sites

The Sites screen lists every site you have connected, and is where you add, edit or remove one. With no sites connected, it is the first useful thing in the application.

The site list

Each row shows the site's favicon once Grafida has found one, its title and its address, whether it is connected, and how many local articles belong to it. Three things you can do with a row:

• Press the row itself to open the site's form for editing.
• Set as active site makes it the site the Articles and Media screens work on, and takes you straight to its articles. Only one site is active at a time.
• Delete removes the site, its cached data, its local articles and its stored token. It does not delete anything from the site itself, and it does not touch any .grafida files you have already exported. Grafida asks first, and names the site it is about to remove.

A row carrying Locked is one that asks you to authenticate before it opens. That is switched on per site under Protected sites on the Settings screen; see App Lock for what it does and does not protect against.

A row may also carry Token stored unencrypted. That means the token for this site is sitting in a plain column of the database rather than in your system's secret store — which is how Akeeba's older desktop Grafida stored it. Grafida reads such a token so that the site keeps working, and never writes one. To move it somewhere safer, open the site, paste the token in again and save.

Adding or editing a site

The form has seven fields.

Field	What it does
Title	The label shown throughout 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 is always shown blank — Grafida never displays a stored token back to you — so leave it empty to keep what is saved, or paste a new one to replace it.
Editor CSS URL	Optional. Leave it blank unless the article text looks visibly unlike the way it renders on your site. See below.
Media filesystem	Which of the site's Media Manager filesystems uploads go to. Automatic lets the site decide.
Media upload folder	A folder created inside that filesystem for anything Grafida uploads, so your uploads stay easy to find. Defaults to grafida when left blank.
Unicode aliases	See below.

The buttons below the form are Save, Test connection, Cancel, and — once a token is stored — Remove stored token.

Grafida checks the URL while you type it and says so at once if the address is not one it can use. Every field on the form is written on every save, including a save where you only changed the title.

Test connection

Test connection contacts the live site with the address and token you have, reports success with the API address it found, or explains what went wrong. It needs the site to have been saved first. Nothing on the form is stored by the test itself.

Connection Troubleshooting explains each failure.

Remove stored token

This is the deliberate, named way to take a credential out of Grafida. Nothing else removes one: an ordinary save with an empty token box keeps the token that is already there, and editing a site's title never disturbs its credentials. Grafida asks for confirmation.

After removing the token the site stays in the list, with its local articles intact, but nothing that needs the network works until you enter a token again.

Editor CSS URL

Joomla can style an editor's text area to look like the site's own template, using a stylesheet usually called editor.css. Grafida looks for it automatically by asking the site which template styles are in use and by reading the site's home page.

That first route needs a reasonably privileged token, so if you connected with a lesser account and the article text in the editor looks nothing like your site, set the path here — for example media/templates/site/mytemplate/css/editor.css. Leaving the field blank restores the automatic search; an empty value really does clear the override.

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, turns that restriction off so that titles in Greek, Cyrillic, CJK and other scripts keep their own characters.

Reading that setting over the API needs a token with administrative rights, so Grafida cannot always ask. Leave this on Automatic to let it try, or set Yes or No to tell it outright. What you choose here decides the alias Grafida previews as you type a title; the site applies its own rule again when the article is published.