Frequently Asked Questions

1. How to set up SMTP configuration ?

Please follow the steps:
Setp 1:

Go to the path in your application: app/Config/constants.php

Setp 2:

Set the following in Gmail SMTP:

define("SMTP_HOST", "ssl://smtp.gmail.com");
define("SMTP_PORT", "465");
define("SMTP_UNAME", "youremail@gmail.com");
define("SMTP_PWORD", "******");

Please provide your smtp username and password to working the email properly.
If you are finding problem after setting the username and password then please check the below:
Go to your php.ini file and enable the "php_openssl" in you PHP setting.
You need to enable extension=php_openssl.dll on php.ini file.If you are still facing the problem then the port 465 is not available.
Please contact with your server administrator.​

2. How to Check email working ?

Please run the following URL to check email is working or not:

http://DOMAINNAME/SUB_FOLDER/cron/test_email/?to=emailId

Example:
http://localhost/orangescrum/cron/test_email/?to=emailId (if you are using localhost)
http://127.0.0.1/orangescrum/cron/test_email/?to=emailId (if you are using IP)
http://myprojects.orangescrum.com/cron/test_email/?to=emailId (if you are using any valid domain)
If the email is not working then please follow the installation guide again.

Check gmail security issues here. Please see below links , you have to change some configuration at email end.

https://support.google.com/accounts/answer/6010255?hl=en
https://www.google.com/settings/security/lesssecureapps

Also check app/tmp/logs/os-email.log file for any error.

3. How to fix "Email reply on task notifications not working" ?

  1. Check Whether imap is enabled or not.

    In case IMAP is not enabled , please follow below steps in Linux:

    Step 1:

    apt-get install php5-imap

    Step 2:

    php5enmod imap

    Step 3:

    /etc/init.d/apache2 restart

  2. Check gmail security issues here. Please see below links , you have to change some configuration at email end.

    https://support.google.com/accounts/answer/6010255?hl=en
    https://www.google.com/settings/security/lesssecureapps

    Also check app/tmp/logs/os-email.log file for any error.

4. How to fix upload image issue ?

This issue is fixed in new version. If you are using the older version then please follow the steps:
Setp 1:

Go to the file: app/webroot/users/image_thumb/index.php
Put the below code beginning of the file.

if (!defined('DS')) {
  define('DS', DIRECTORY_SEPARATOR);
}
if (!defined('WWW_ROOT')) {
  $dir = dirname(__FILE__);
  define('WWW_ROOT', substr($dir,0,stripos($dir,'webroot')+strlen('webroot')). DS);
}

Setp 2:

Please replace the following code(Line number 57):

Existing code: $fileurl = HTTP_ROOT.'users/files/photos/'.$userdata['User']['photo'];
New code: $fileurl = HTTP_ROOT.'files/photos/'.$userdata['User']['photo'];

5. How to set Subfolder ?

You will get the below output, if the SUB_FOLDER in the constants.php file is not set properly.

Ex:- Let your sub folder is "orangescrum".
You set up SUB_FOLDER as define('SUB_FOLDER', 'orangescrum');
instead of define('SUB_FOLDER', 'orangescrum/');

6. Issue on Ubuntu with respect to htaccess ?

If you see first page is broken. Then add below content to htaccess file.
Step 1:

orangescrum folder path - Make sure please create a folder called 'orangescrum' underneath html folder and copy source
code here.

/var/www/html/orangescrum

Step 2:

Open this file and edit vi /etc/apache2/apache2.conf
Add this below file ( AllowOverride All instead of AllowOverride None)

<Directory /var/www/html/>
   Options Indexes FollowSymLinks
   AllowOverride All
   Require all granted
</Directory>

Save the file and restart the Apache service.

Step 3:

Enable this module and restart the Apache service

sudo a2enmod rewrite
sudo a2enmod headers
service apache2 restart

7. How to "Add" and "Remove" users to an existing project ?

We will refer to some images along with the articles to show you better how you exactly do that.
Let’s see how to Add Users to an existing Project;
Step 1:

Click on 'Project' button to select a project you had already created.

Step 2:

When you hover on ‘You project’ a menu will appear at the bottom. From that menu select Add/remove users as you wish to do.

Step 3:

Step 4:

A second window will open showing the name of the users that exist in that project. Tick mark the name(s) and take the required 'Add/Remove' users action.

SECOND METHOD

Step 1:

Go to 'users' button on the Left hand side of the screen. Click it.

Step 2:

When you click it, the screen will show a button "Invite Users". Click it.

Step 3:

Enter the email ID’s along with the name of the project to be assigned to the users. Click on Add button below and it is all done.

8. Daily catch up feature not working or is disabled after installation ?

The Daily catch up is a feature fully available in Open community version. If by chance it is not working or is disabled; Use these two files from the below GIT links and replace them in your project folder.

https://github.com/Orangescrum/orangescrum/raw/9bc393df0eb94eab6805032f2debf17b61c936b4/app/Controller/ProjectsController.php

https://raw.githubusercontent.com/Orangescrum/orangescrum/9bc393df0eb94eab6805032f2debf17b61c936b4/app/View/Projects/groupupdatealerts.ctp

Although the app/Controller/ProjectsController.php and the app/View/Projects/groupupdatealerts.ctp has been updated and issue has been fixed.

9. Google login is not working ?

After configuring the installation and installing the Google API details on constants. Sometime the login with Google might have a problem like this;

Error 400.
Error: redirect_uri_mismatch
Application:
The redirect URI in the request:
http://.com/orangescrum/users/googleConnect did not match a registered redirect UR
Solution :

Go to your constants.php and be sure that your SUB_FOLDER constant is the following:

define('SUB_FOLDER', '');

If you put change it, like the login suggests you, in:

define('SUB_FOLDER', '/');

This should serve as the solution to such a problem.

Please note: There can be different problems that can appear. This solution is not relevant for a specific problem. If there is another problem, please take a screen shot, write the problem and share it with OrangeScrum Team to have a look.

10. How to ensure quickly no login and css problem after installation in open community version 1.5.8 ?

Even after thorough manual ridden installation of v 1.5.8' if you can't login and CSS is not loading' no error message is being displayed. Be sure of two things;

A. Such a problem is not the package problem you receive to download and install the application.

B. This is the problem related to the configuration of your server.

C. This can be solved with the .htaccess in the root.

Please find the solution below;

<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /
RewriteRule ^$ app/webroot/ [L]
RewriteRule (.*) app/webroot/$1 [L]
</IfModule>

11. Send emails without SMTP ?

If you want to send emails to your internal server without authentication use the below code to get the following changes in place;

“Replace define("EMAIL_DELIVERY", "mail"); in place of define("EMAIL_DELIVERY", "smtp"); in constants.php app/Config/constants.php”

12. What to do when quick Sign up fails when installing on WAMP ?

So while Installing on WAMP, in the problem you would generally notice that after having filled up the form and clicked the sign up button, the button turns to a broken symbol and the app goes nowhere, also the system states that the file is not found.

Following could be the possibilities that you should check out;

A. Check out the constants.php and database.php file.

B. You might not have set the SUB_FOLDER properly in constants.php
Ex. define('SUB_FOLDER', 'Your subfolder name/');

C. Or the .htaccess may not working.
Activate htaccess on your environment/server.

Please refer to the following codes below with the possibility if the orangescrum.zip file does not include the required .htaccess file in the root folder.

<IfModule mod_rewrite.c>
RewriteEngine on
RewriteBase /
RewriteRule ^$ app/webroot/ [L]
RewriteRule (.*) app/webroot/$1 [L]
</IfModule>

Or visit; http://www.orangescrum.org/how-to-install-orangescrum-in-godaddy for the complete instructions on how to install OrangeScrum on your go-daddy server.

13. Having Sign up problems even after a successful installation ?

To ensure you have a successful sign up after installation, follow the manual given below;

Please make sure of the following;
  • SUB_FOLDER should be set in the constants.php file –

    define('SUB_FOLDER', 'orangescrum/'); instead of define('SUB_FOLDER', 'orangescrum');
    Note: you can replace "orangescrum" with the folder you created.

  • You have write permission to app/tmp and app/webroot folder.

  • Import database.sql to your database.

  • htaccess should be enabled.

14. How to fix Download task issue ?

Please follow the steps:
Step 1:

Please create a folder 'zipTask' inside 'app > webroot > DownloadTask' directory.

Step 2:

Give write permission to the folder zipTask as well as DownloadTask.

Download will work as expected.

15. What about the refund policy ?

We do not process refunds for add-ons or installation services. However, we will support issues if any encountered during the add-on installation (provided you've followed and met our installation requirements). Also, we recommend reviewing our add-on demos before making a purchase.