1 // Moodle Development Kit configuration file
3 // A comment in this file MUST be preceded by white spaces or nothing.
5 // This configuration file will be looked for in those directories:
6 // - ~/.moodle-sdk/config.json
7 // - /etc/moodle-sdk/config.json
11 // Directories to work with.
12 // All of them must exist and must be writeable by the current user.
13 // www and storage CANNOT point to the same directory and must be writeable.
15 // The web directory you are going to access Moodle from, typically your virtual host DocumentRoot.
16 // A symlink to the web directory of your Moodle instance will be created here.
18 // The directory where the instances will be stored.
19 "storage": "~/moodles",
20 // A directory used by MDK to store different kind of things such as scripts and backups.
21 "moodle": "~/.moodle-sdk",
22 // Used for cached repositories and stuff which could be shared system-wide.
23 "mdk": "~/.moodle-sdk"
26 // List of remotes to work with
27 // The integration branch MUST end with integration.git
29 "stable": "git://git.moodle.org/moodle.git",
30 "integration": "git://git.moodle.org/integration.git",
31 "mine": "git@github.com:YourGitHub/moodle.git"
36 // Name prefix for all databases created by mdk. Affects the database name only, not the tables.
58 // Define the way your want things to be called
61 // How to name your instances
62 "prefixStable": "stable_",
63 "prefixIntegration": "integration_",
64 "prefixMaster": "master",
65 "suffixSeparator": "_",
67 // How to name your branches
68 // Read the doc about Python regular expressions if you need to modify them
69 // http://docs.python.org/library/re.html
70 "branchFormat": "MDL-%(issue)s-%(version)s",
71 "branchSuffixSeparator": "-",
72 "branchRegex": "^MDL-(?P<issue>[0-9]+)-(?P<version>[0-9a-z]+)(-(?P<suffix>[a-z0-9_-]+))?",
74 // How to name your Moodle installation
75 "integration": "Integration",
83 // The information for integrating MDK with Jira
85 "url": "https://tracker.moodle.org/",
88 "repositoryurl" : "Pull from Repository",
90 "branch" : "Pull 2.2 Branch",
91 "diffurl" : "Pull 2.2 Diff URL"
94 "branch" : "Pull 2.3 Branch",
95 "diffurl" : "Pull 2.3 Diff URL"
98 "branch" : "Pull 2.4 Branch",
99 "diffurl" : "Pull 2.4 Diff URL"
102 "branch" : "Pull 2.5 Branch",
103 "diffurl" : "Pull 2.5 Diff URL"
106 "branch" : "Pull 2.6 Branch",
107 "diffurl" : "Pull 2.6 Diff URL"
110 "branch" : "Pull 2.7 Branch",
111 "diffurl" : "Pull 2.7 Diff URL"
114 "branch" : "Pull Master Branch",
115 "diffurl" : "Pull Master Diff URL"
119 // The base for diff URLs, you can use the following wildcards:
120 // - %branch%: The branch name;
121 // - %stablebranch%: The stable branch (MOODLE_23_STABLE, MOODLE_24_STABLE, master, ...);
122 // - %headcommit%: The head commit.
123 // This is used to populate the fields on the tracker issue.
124 "diffUrlTemplate": "https://github.com/YourGitHub/moodle/compare/%headcommit%...%branch%",
126 // The public acccess URL of your repository. It is used to populate the fields on the tracker issue.
127 "repositoryUrl": "git://github.com/YourGitHub/moodle.git",
129 // Plugins related settings.
132 // Set this setting to false to disable the caching of plugins locally.
135 // Local repository for plugins missing on the database.
139 "downloadurl": "https://github.com/FMCorz/moodle-auth_mdk/archive/master.zip"
145 // The scheme to set during an install (http or https)
147 // The host name to set during an install
149 // Path to your Moodle instances, http://host/path/ should point to dirs.www.
151 // Moodle admin login
153 // Moodle admin password
155 // What to call your remote, the one pointing to remotes.mine
156 "myRemote": "github",
157 // What to call the upstream remote, the one pointing to the official repositoriy (stable or integration)
158 "upstreamRemote": "origin",
160 // Config setting that should be set in config.php when an instance is being installed.
162 // The following example will set CFG->divertallemailsto to "root@localhost.local".
163 // "divertallemailsto": "root@localhost.local"
166 // Behat related settings
169 // From 2.7 Behat requires a different wwwroot than the one set in config.php.
170 // MDK assumes that the only thing that will differ between the wwwroot and
171 // behat wwwroot is the host, nothing else. Use a ServerAlias or /etc/hosts entries.
173 // The number of seconds the behat command will sleep after launching the PHP Server, or Selenium.
177 // The name of the data directory (in dirs.storage/instanceName/)
178 "dataDir": "moodledata",
179 // The name of the www directory (in dirs.storage/instanceName/)
181 // The name of the extra directory, it will be used to store different things of an instance (in dirs.storage/instanceName/)
183 // The name of the web accessible directory that MDK uses to give access to the extraDirs (created in dirs.www/).
186 // The default engine to use when not specified
187 "defaultEngine": "mysqli",
190 "git": "/usr/bin/git",
192 "php": "/usr/bin/php",
194 "java": "/usr/bin/java",
196 "recess": "/usr/local/bin/recess",
198 "lessc": "/usr/local/bin/lessc",
200 "shifter": "/usr/bin/shifter",
202 "yuidoc": "/usr/local/bin/yuidoc",
203 // Path to your favourite editor. Set to null to guess it from the System environment.
206 // Debug level of MDK. 'debug', 'info', 'warning', 'error' or 'critical'.
209 // When enabled, MDK will try to be smart to identify the parent commit of the current branch. Instead of
210 // using the stable branch it will match the branch name with an issue number and compare it with the commit
211 // messages. The first commit message that does not match the pattern MDL-12345 will be used as the headcommit.
212 "smartHeadCommitSearch": true,
214 // Limit the search of the head commit to the last n commits.
215 "smartHeadCommitLimit": 50,
217 // Name of the symlink pointing to the data directory to create in the www directory
218 // during an instance creation. If false, the symlink won't be created.
219 "symlinkToData": false,
221 // By default MDK caches origin as a local mirror. It is much faster when it comes to upgrading
222 // a couple of instances at the same time. MDK will update the mirror as often as it needs to,
223 // but if you are not using MDK to upgrade your instances, you might want to disable this
224 // functionality to only rely on the real origin. Creating new instances will not be affected
226 "useCacheAsUpstreamRemote": true,
228 // You should not edit this, this is the branch that is considered as master by developers.
231 // Aliases for MDK commands.
232 // An alias starting with a ! will be executed through the command line. Those also
233 // can use placeholders for arguments: $1, $2, ...
235 // "upall": "update --all". `mdk upall` will execute `mdk update --all`
236 // "ls": "!ls -al". `mdk ls` will execute `ls -al`
240 "theme": "!mdk info -v theme -e $1 $2"