Troubleshooting

What Are the Technical Requirements for UpStream?

We highly recommend that any website using UpStream also uses PHP 5.6. You can see our official recommendations at the UpStream page on WordPress.org: image Why PHP 5.6? Because PHP itself does not support anything lower than 5.6. Click here for more details on PHP version support. Any version of PHP before 5.6 doesn’t have security updates and will not keep your site safe. WordPress officially recommends that you use PHP 7. Does my site meet the PHP requirements? If you are unsure of what version of PHP your site is using, you can go to Tools > Site Health to find out. - After installing the Health Check plugin, go to Dashboard, then “Health Check”. - Click the “Info” tab. - You’ll find your PHP version under the “Server” tab: imageimageOther recommendationsDatabase: MySQL version 5.6 or greater or MariaDB version 10.0 or greater.Server: We recommend Apache or Nginx as the most robust and secure server for running WordPress, but any server that supports PHP and MySQL will do.For the official WordPress recommendations, please check here.

How to Debug Errors on UpStream Screens

If buttons or actions are not working on the frontend or admin area of your UpStream site, you may have a conflict with another plugin. Or, you might have found a bug in UpStream. The best way to debug errors UpStream is to use the Chrome browser. - Visit the frontend of UpStream using Chrome. - Right-click to bring up the options show in the image below. - Click “Inspect element”. image - You will now see a sidebar in Chrome that looks like this next image. - Click the “Console” tab: imageimage - Try the action in UpStream that’s not working. For example, one customer reported that the “delete” button was not working for discussion. In that example, they need to click “delete”. imageimage - You may now see some errors in the “Console” tab. Copy those errors and report them to our team at help@upstreamplugin.com. imageimage

Troubleshooting Comments in UpStream

SSL problems If UpStream comments don’t appear in the front or admin area of your site, the most likely issue is a wrongly configured SSL certificate. If comments don’t show, make sure your entire site is running over either http or https. If your site switches between http and https (whether accidentally, or on purpose), that can cause problems with comments. Problems with Administrator comment It’s been reported that the Advanced Access Manager plugin needs a small tweak to work with UpStream. If Advanced Access Manager is installed, then Administrator accounts may be not be fully operational in the UpStream Comments area. Click here for the solution.

Is Your Site Correctly Configured for SSL?

One of the most common issues we find with UpStream customers is an incorrectly configured SSL certificate. This problem often results in a site that works perfectly in the admin area, but has glitches on the front-end. If your site’s SSL is incorrectly configured, some parts of WordPress and UpStream will load via https:// and some will load via https://. This will often lead to buttons not working on the frontend of UpStream, or to random log outs. If you are having frontend problems, make sure to read your hosting company’s advice on setting up an SSL certificate. Here are some sample guides: - GoDaddy’s SSL instructions - WPEngine SSL instructions - Pantheon SSL instructions One common place to start looking for SSL troubles is under “Settings”, then “General”. Make sure the “WordPress Address (URL)” and “Site Address (URL)” options are set to https, as in the image below?: image You may also want to look at your site’s .htaccess file. It should contain code like this: RewriteEngine On RewriteCond %{SERVER_PORT} 80 RewriteRule ^(.*)$ https://example.com/$1 [R,L]

How to Choose Custom Permalinks for UpStream Projects

You can now change the permalinks for the frontend of your UpStream projects. The /projects/ URL can cause conflicts with other themes and plugins, so you can choose your own UpStream permalinks. Permalinks for projects in UpStream Yes, you can choose also choose URLs for Clients. At the moment, Clients aren’t easily accesible and editable from the frontend of UpStream, but we’re working on that!

How to Troubleshoot UpStream Permissions

If you’re having trouble with permissions in UpStream, one common solution is to reset the permissions to their default value. - In your WordPress admin area, go to UpStream > General. - Scroll down to the “Maintenance” area. - You’ll see an area called “Add default UpStream capabilities”. - Click these buttons to reset the permissions for the user roles: image The “Administrator” role is part of the WordPress core. By default, UpStream provides those other three user groups: - UpStream Manager - UpStream User - UpStream Client User If you would like to see what each role can do by default, you can check out our Default UpStream Permissions Chart

UpStream and the Advanced Access Manager Plugin

It’s been reported that the Advanced Access Manager plugin needs a small tweak to work with UpStream. If Advanced Access Manager is installed, then Administrator accounts may be not be fully operational in the UpStream Comments area. - In your WordPress site, go to “AAM” in the admin menu. - Click the “Settings” icon: image - Set “Backend Access Control” to “Disabled”. imageimage