Site Navigation

gosite

Interactively select a Joomla site and navigate to its folder in one command.

Usage

gosite

Shell function requirement

Because a script cannot change the shell's working directory directly, gosite requires a wrapper function in your shell configuration file. The installer adds this automatically, but if you need to add it manually:

For ~/.zshrc or ~/.bashrc:

function gosite() { cd "$(command gosite "$@")"; }

After adding it, reload your shell:

source ~/.zshrc   # or source ~/.bashrc

What it does

1. Scans ROOTFOLDER (up to 3 directory levels deep) for folders containing a configuration.php file
2. Displays a numbered list of all found Joomla sites, sorted alphabetically
3. Prompts you to select a site by number
4. Changes your working directory to the selected site

Example

$ gosite

Found 3 Joomla website(s):

 1) /Users/me/Development/sites/client-a
 2) /Users/me/Development/sites/mysite
 3) /Users/me/Development/sites/testsite

Select a site to navigate to (1-3): 2
$ pwd
/Users/me/Development/sites/mysite

---

jlistjoomlas

List all Joomla installations found under the configured root folder, with version and database details.

Usage

jlistjoomlas [-s] [-r <release>] [-h]

Options

Option	Description
-s	Short mode - only display path and Joomla version
-r <release>	Filter by major version prefix (e.g. 4 or 5)
-h	Display help

What it does

Scans ROOTFOLDER (up to 2 directory levels) for configuration.php files and detects the Joomla version. Supports Joomla 1.0 through 5.x.

Full output (default)

Sitename    : My Joomla Site
Version     : 5.2.3
DB Name     : db
DB User     : db
DB Password : db
DB Host     : db
DB Prefix   : abcde_
Path        : /Users/me/Development/sites/mysite

Short output (with -s)

/Users/me/Development/sites/mysite                5.2.3
/Users/me/Development/sites/client-a              4.4.1

Examples

List all Joomla sites with full details:

jlistjoomlas

List only Joomla 5 sites in short format:

jlistjoomlas -s -r 5