Implemented the following environment variable options:

* `SA_OPTION_CONFIGURATIONS_DIR`: Set to a custom value to change/override the directory where Configuration Files are stored.
* `SA_OPTION_LOGS_DIR`: Set to a custom value to change/override the directory where Log Files are stored.
#108

Author: end2endzone

UserManual.md

@@ -46,7 +46,7 @@ This manual includes a description of the system functionalities and capabilitie
   * [Multi-selection-based properties](#multi-selection-based-properties)
   * [Fixed properties](#fixed-properties)
   * [Default properties](#default-properties)
-* [Environment variables](#environment-variables)
+* [Environment Variables options](#environment-variables-options)
 * [Tools](#tools)
   * [file_explorer_renew](#file_explorer_renew)
   * [arguments.debugger](#argumentsdebugger)
@@ -169,14 +169,16 @@ A *configuration file* contains the definition of all [<menu>](#Menu) elem
 
 When a user right-click on a file in *Windows Explorer*, the application will load all available *configuration files* and display their content into the displayed context menu.
 
-The list of *Configuration Files* is unique for each users of the system. The files are stored in `C:\Users\%USERNAME%\ShellAnything\configurations` directory where `%USERNAME%` is your current Windows session *username*. Note that *Windows Explorer* also support copy & pasting `C:\Users\%USERNAME%\ShellAnything\configurations` into an *address bar* to quickly jump to the directory.
+The list of *Configuration Files* is unique for each users of the system. The files are stored in `C:\Users\%USERNAME%\ShellAnything\configurations` directory where `%USERNAME%` is your current Windows session *username*. Note that you can paste `C:\Users\%USERNAME%\ShellAnything\configurations` into an *address bar* of *Windows Explorer* to quickly jump to the directory.
 
 The application support multiple *configuration files* at the same time. One can add new files in the *configuration directory* and the system will automatically detect and load them.
 
 When a *configuration file* is deleted, the application automatically detect the missing file and properly unload the associated menus which stop displaying their content.
 
 To temporary disable a *configuration file*, one can simply change the file extension from `xml` to `txt`. Change the file extension back to `xml` to re-enable the file.
 
+**Note:** The *Configuration Files* directory can be modified with the `SA_OPTION_CONFIGURATIONS_DIR` environment variable option. See [Environment Variables options](#environment-variables-options) section for details.
+
 
 
 ## Basic Xml Document ##
@@ -1822,7 +1824,7 @@ For example, the following would define `services.wce.command.start` and `servic
 
 
 
-# Environment variables #
+# Environment Variables options #
 
 ShellAnything default startup behavior can be modified by setting specific pre-defined environment variables. Some features or configuration options can also be enabled or disabled through environment variables. For example, one can define an environment variables to enable verbose logging.
 
@@ -1834,10 +1836,11 @@ All ShellAnything environment variables names are prefixed with `SA_`.
 
 The following table defines the list of pre-defined environment variables for ShellAnything:
 
-| Name                           | Description                                                                                                        |
-|--------------------------------|--------------------------------------------------------------------------------------------------------------------|
-| SA_OPTION_LOGGING_VERBOSE      | Enables [verbose logging](#verbose-logging) when set to a value that evaluates to [true](#istrue-attribute).       |
-
+| Name                           | Description                                                                                                          |
+|--------------------------------|----------------------------------------------------------------------------------------------------------------------|
+| SA_OPTION_LOGGING_VERBOSE      | Enables [verbose logging](#verbose-logging) when set to a value that evaluates to [true](#istrue-attribute).         |
+| SA_OPTION_CONFIGURATIONS_DIR   | Set to a custom value to change/override the directory where [Configuration Files](#configuration-files) are stored. |
+| SA_OPTION_LOGS_DIR             | Set to a custom value to change/override the directory where [Log Files](#logging-support) are stored.               |
 
 
 
@@ -2653,6 +2656,9 @@ The logging directory is unique for each users of the system.
 
 The log files are stored in `%LOCALAPPDATA%\ShellAnything\logs` directory. For example, the user `JohnSmith` can find his own ShellAnything log files in directory `C:\Users\JohnSmith\AppData\Local\ShellAnything\logs`.
 
+**Note:** The logging directory can be modified with the `SA_OPTION_LOGS_DIR` environment variable option. See [Environment Variables options](#environment-variables-options) section for details.
+
+
 
 ### Filename Format ###
 

src/core/App.cpp

@@ -26,6 +26,7 @@
 #include "LoggerHelper.h"
 #include "ConfigManager.h"
 #include "PropertyManager.h"
+#include "Environment.h"
 
 #include "rapidassist/process_utf8.h"
 #include "rapidassist/user_utf8.h"
@@ -204,6 +205,15 @@ namespace shellanything
 
     //By default, GLOG will output log files in %TEMP% directory.
 
+    // Issue #108. Log files directory can be overriden with an option.
+    Environment& env = Environment::GetInstance();
+    if (env.IsOptionSet(Environment::SYSTEM_LOGS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME))
+    {
+      std::string log_dir = env.GetOptionValue(Environment::SYSTEM_LOGS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME);
+      if (IsValidLogDirectory(log_dir))
+        return log_dir;
+    }
+
     // Issue #108. Log files should be stored in %LOCALAPPDATA%\ShellAnything\logs
     std::string localappdata_dir = ra::environment::GetEnvironmentVariableUtf8("LOCALAPPDATA");
     if (!localappdata_dir.empty() && ra::filesystem::DirectoryExistsUtf8(localappdata_dir.c_str()))
@@ -239,6 +249,15 @@ namespace shellanything
 
   std::string App::GetConfigurationsDirectory()
   {
+    // Issue #108. Configuration Files directory can be overriden with an option.
+    Environment& env = Environment::GetInstance();
+    if (env.IsOptionSet(Environment::SYSTEM_CONFIGURATIONS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME))
+    {
+      std::string config_dir = env.GetOptionValue(Environment::SYSTEM_CONFIGURATIONS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME);
+      if (IsValidConfigDirectory(config_dir))
+        return config_dir;
+    }
+
     //get home directory of the user
     std::string home_dir = ra::user::GetHomeDirectoryUtf8();
     std::string app_dir = home_dir + "\\" + app_name;

src/core/Environment.cpp

@@ -33,6 +33,8 @@ namespace shellanything
   static const std::string EMPTY_VALUE;
 
   const std::string Environment::SYSTEM_LOGGING_VERBOSE_ENVIRONMENT_VARIABLE_NAME = "SA_OPTION_LOGGING_VERBOSE";
+  const std::string Environment::SYSTEM_CONFIGURATIONS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME = "SA_OPTION_CONFIGURATIONS_DIR";
+  const std::string Environment::SYSTEM_LOGS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME = "SA_OPTION_LOGS_DIR";
 
   Environment::Environment()
   {
@@ -67,6 +69,12 @@ namespace shellanything
     return is_true;
   }
 
+  std::string Environment::GetOptionValue(const std::string& name) const
+  {
+    std::string value = ra::environment::GetEnvironmentVariableUtf8(name.c_str());
+    return value;
+  }
+
   bool Environment::IsOptionFalse(const std::string& name) const
   {
     std::string value = ra::environment::GetEnvironmentVariableUtf8(name.c_str());

src/core/Environment.h

@@ -54,6 +54,16 @@ namespace shellanything
     /// </summary>
     static const std::string SYSTEM_LOGGING_VERBOSE_ENVIRONMENT_VARIABLE_NAME;
 
+    /// <summary>
+    /// Name of the environment variable that defines the configurations directory path override.
+    /// </summary>
+    static const std::string SYSTEM_CONFIGURATIONS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME;
+
+    /// <summary>
+    /// Name of the environment variable that defines the logs directory path override.
+    /// </summary>
+    static const std::string SYSTEM_LOGS_DIR_OVERRIDE_ENVIRONMENT_VARIABLE_NAME;
+
   public:
 
     /// <summary>
@@ -64,6 +74,13 @@ namespace shellanything
     /// <returns>Returns true if the environment variable is set. Returns false otherwise.</returns>
     bool IsOptionSet(const std::string& name) const;
 
+    /// <summary>
+    /// Get the value of an option.
+    /// </summary>
+    /// <param name="name">The name of the environment variable to check.</param>
+    /// <returns>Returns the value of the given environment variable.</returns>
+    std::string GetOptionValue(const std::string& name) const;
+
     /// <summary>
     /// Check if an environment variable evaluates to true.
     /// An empty environment variable value returns false.