Top Menu

Jump to content
Home
    Modules
      • Projects
      • Activity
      • Work packages
      • Gantt charts
      • Calendars
      • Team planners
      • Boards
      • News
    • Getting started
    • Introduction video
      Welcome to OpenProject Community
      Get a quick overview of project management and team collaboration with OpenProject. You can restart this video from the help menu.

    • Help and support
    • Upgrade to Enterprise edition
    • User guides
    • Videos
    • Shortcuts
    • Community forum
    • Enterprise support

    • Additional resources
    • Data privacy and security policy
    • Digital accessibility (DE)
    • OpenProject website
    • Security alerts / Newsletter
    • OpenProject blog
    • Release notes
    • Report a bug
    • Development roadmap
    • Add and edit translations
    • API documentation
  • Sign in
      Forgot your password?

      or sign in with your existing account

      Google

Side Menu

  • Overview
  • Activity
    Activity
  • Roadmap
  • Work packages
    Work packages
  • Gantt charts
    Gantt charts
  • Calendars
    Calendars
  • Team planners
    Team planners
  • Boards
    Boards
  • News
  • Forums

Content

General discussion
  1. OpenProject
  2. Forums
  3. General discussion
  4. Installing Plugins

Installing Plugins

Added by Justin Bowers over 10 years ago

I just posted a problem that I’m seeing with creating new projects earlier, but I had another question in regards to installing plugins.

On the https://openproject.org/download/install-plugins/ page, it states that you can install plugins by listing them in “Gemfile.plugin”. I’m inexperienced with both OpenProject and Ruby, so I don’t know where this file is actually located. I browsed a few directories on my server, but couldn’t really find where this file is (let alone the actual install directory for OpenProject).

I tried searching on the forums for this file location, but was unable to find it. I’m sure it’s something simple.

Also, I was looking to install a plugin that would give me the same functionality as the Forums here. I didn’t see it listed though on the plugins page. Is this a plugin that users can download?

Thanks!


Replies (8)

RE: Installing Plugins - Added by Robin Wagner over 10 years ago

Hi Justin,

forums are actually part of the OpenProject core. You don’t need any plugin to use them.
In order to display a forum you first need to create a forum in “Project settings” > tab “Forum” > “New forum”.
Make sure the “Forums” module is activated: “Project settings” > “Modules” > check “Forums”.

Regarding the installation of plugins: You need to create the Gemfile.plugin first:

Plugins in OpenProject behave like normal ruby gems. To preserve the distinction between gems required for OpenProject itself and the plugin gems we decided to have a distinct Gemfile for the later. That way it is also easier to update.

  • Create a file called Gemfile.plugins in the OpenProject root directory.
  • Within the Gemfile.plugins file add the plugins of your choice. (as outlined on https://openproject.org/download/install-plugins/)

Best regards,
Robin

RE: Installing Plugins - Added by Justin Bowers over 10 years ago

Thanks for the quick response Robin. I’m unable to create a forum yet since I receive an error attempting to create a project. I just didn’t see a setting for it under the administration section, so I wasn’t sure about it.

So I’ll have to create a Gemfile.plugins file first, and you said that I need to put that in the OpenProject root directory. However, I don’t know where the OpenProject root directory is located. Where is the default location on Wheezy?

RE: Installing Plugins - Added by Robin Wagner over 10 years ago

Hello Justin,

I just saw from your other post that you installed OpenProject using packager.
The above mentioned approach is relevant for the manual installation of OpenProject.

Officially, plugins for packager installations are not yet supported (in this case a manual installation is strongly suggested (see also the information on the packager site )).

The use of plugins in combination with the packager installation has not been tested but it is theoretically possible.
For some information you may have a look here: https://gist.github.com/crohr/10111721
(But you should know what you’re doing if you plan to install plugins for your packager installation.)

Best regards,
Robin

RE: Installing Plugins - Added by Justin Bowers over 10 years ago

Oh Ok. I just followed the instructions on your website. I saw where there was manual instructions, but didn’t know there was a difference in the functionality. Maybe I should try to reinstall it using the manual instructions instead (since I’m also having a problem creating projects)?

RE: Installing Plugins - Added by Robin Wagner over 10 years ago

Hello Justin,

yes, you’re right. It should be more clearly labeled that plugins are currently only supported for the manual installation.
If you plan to use plugins, the manual installation is probably the better choice.
Note however that the manual installation involves quite a lot of steps (unlike the packager installation).
It will most likely be easier to try the packager installation again if the core features are sufficient for you.

But it doesn’t hurt to give the manual installation a try. :)

You can find the manual installation instructions here: Installation instructions.

Best,
Robin

RE: Installing Plugins - Added by Justin Bowers over 10 years ago

Hi Robin,

I deleted and reinstalled my Linode with a fresh copy of Debian 7.7. I followed your manual instructions and everything installed successfully. However, when I try to visit my openproject site, I receive a directory listing which shows the following files and folders:

404.html
422.html
500.html
assets (directory)
favicon.ico
javascripts (directory)
templates (directory)

I’m unsure why the site isn’t loading properly, so any help is appreciated.

Thanks!

RE: Installing Plugins - Added by Justin Bowers over 10 years ago

Hi Robin,

FYI - I was able to successfully install OpenProject using the manual instructions on my local Debian box. Since it worked without an issue, I reloaded and attempted again on my Linode. Everything seems to be working fine now.

Thanks!

RE: Installing Plugins - Added by Robin Wagner over 10 years ago

Hi Justin,

great job! :)
That’s good to hear.
Have fun with OpenProject!

  • (1 - 8/8)
Loading...