You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -51,13 +51,13 @@ or, if you followed the "Optional Setup" above, just
51
51
### Getting Started
52
52
53
53
The Shell extension looks for commands in the `bin/` folder of extensions you have installed, and also in `workspace/bin/`. You can see a list of commands by running `symphony` without any arguments. A list like this will be displayed:
54
-
54
+
```
55
55
Below is a list of all available commands. (use --usage for details on
56
56
executing individual commands):
57
57
58
58
shell/hello
59
59
shell/token
60
-
60
+
```
61
61
At any time you can use `--usage`, `--help` or `-h` to get help. If you have also specified a command (see below), you will get help for that particular command instead.
62
62
63
63
Use the `-c` or `--command` argument to run a particular command. The value provided is always `[extension]/[command]` or `[workspace]/[command]`. This extension comes with two commands out of the box: `hello` and `token`.
@@ -67,10 +67,10 @@ To run the `hello` command use the following:
67
67
symphony -c shell/hello
68
68
69
69
You should see output like this:
70
-
70
+
```
71
71
Hello! Here are the arguments you passed me.
72
72
0: 'c' => 'shell/hello'
73
-
73
+
```
74
74
### Authentication
75
75
76
76
Some commands may require you are authenticated before you use them. To do this, either provide the name of the user you want to authenticate as with `-u <username>` or the auth token of that user with `-t <token>`. When using `-u`, you will be prompted to enter your password.
@@ -148,11 +148,20 @@ Note that if you follow the "Optional Steps" above, running `symphony` will alwa
148
148
149
149
If you run multiple sites across multiple installations of Symphony, remember that the Shell extension will work with only the installation of Symphony it itself was installed and enabled on.
150
150
151
-
A workaround to this is to use the symlink method and namespace each install.
151
+
A solution is to place the Shell extension folder outside of the Symphony CMS install, symlink the it into each `extensions/` folder per install of Symphony, and provide the path to Symphony at run-time with `$SYMPHONY_DOCROOT`.
152
+
153
+
E.g.
152
154
153
-
For example, you have two sites "Banana" and "Apple". Both are separate installations of Symphony with their own databases. Symlink them using `ln -s /path/to/banana/extension/shell/bin/symphony /usr/local/sbin/symphony-banana` and `ln -s /path/to/banana/extension/shell/bin/symphony /usr/local/sbin/symphony-apple`. Now you can use this shell extension for both and know you are always in the correct context (`> symphony-banana` and `> symphony-apple`).
155
+
One install of Symphony is called banana and another called apple. The same shell extension folder, which is in `~/source` is symlinked accordingly into `extensions` folder.
0 commit comments