kanbanworkflowstimelinescrumrubyroadmapproject-planningproject-managementopenprojectangularissue-trackerifcgantt-chartganttbug-trackerboardsbcf
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
105 lines
3.0 KiB
105 lines
3.0 KiB
OpenProject Documents Plugin
|
|
===========================
|
|
|
|
This plugin adds features to connect and categorize documents with your project.
|
|
|
|
Under `Modules >> Administration >> Enumerations` you can find the section `Document categories`
|
|
where you can define several document categories that projects can use to categorize their documents.
|
|
|
|
Documents can be enabled for every project individually. Simply activate the `Documents` module in the project settings.
|
|
|
|
When you go to any of your projects you can see the entry `Documents` in the main menu. There you can
|
|
attach new documents to the project by following the `New document` link located in the top right corner of the page.
|
|
|
|
The form allows you to select one of the categories you defined earlier, choose a title and define a description.
|
|
You can attach files from your local hard disk to the document entry which will make them available to anybody
|
|
who has access to the document.
|
|
|
|
Requirements
|
|
------------
|
|
|
|
The OpenProject Documents plug-in requires the [OpenProject Core](https://github.com/opf/openproject/) in version greater or equal to *3.0.0*.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
You need to add a line to the `Gemfile.plugins` of OpenProject, specifying the OpenProject version you are using (whereas 'stable/X.Y' specifies the OpenProject version you are using):
|
|
|
|
`gem "openproject-documents", git: "https://github.com/opf/openproject-documents.git", :branch => "stable/X.Y"`
|
|
|
|
*Example:*
|
|
To install the Documents-plugin for 'OpenProject 4.1', add the following line to the `Gemfile.plugins` of OpenProject:
|
|
|
|
`gem "openproject-documents", git: "https://github.com/opf/openproject-documents.git", :branch => "stable/4.1"`
|
|
|
|
Afterwards, run:
|
|
|
|
`bundle install`
|
|
|
|
This plugin contains migrations. To migrate the database, run:
|
|
|
|
`rake db:migrate`
|
|
|
|
|
|
Tests
|
|
-----
|
|
|
|
Assuming you have to following directory structure:
|
|
|
|
```
|
|
.
|
|
├── openproject
|
|
├── openproject-documents
|
|
```
|
|
|
|
Replace the openproject-document ``Gemfile.plugins`` entry with the following:
|
|
|
|
```
|
|
gem "openproject-documents", path: "../openproject-documents"
|
|
```
|
|
|
|
You run the specs with the following commands:
|
|
|
|
```
|
|
cd openproject
|
|
rake db:test:load # this needs to be done only once
|
|
rspec ../openproject-documents
|
|
```
|
|
|
|
Deinstallation
|
|
--------------
|
|
|
|
Remove the line
|
|
|
|
`gem "openproject-documents", git: "https://github.com/opf/openproject-documents.git", :branch => "stable"`
|
|
|
|
from the file `Gemfile.plugins` and run:
|
|
|
|
`bundle install`
|
|
|
|
Please not that this leaves plugin data in the database. Currently, we do not support full uninstall of the plugin.
|
|
|
|
|
|
Bug Reporting
|
|
-------------
|
|
|
|
If you find any bugs, you can create a bug ticket at
|
|
|
|
https://www.openproject.org/projects/documents
|
|
|
|
|
|
Development
|
|
-----------
|
|
|
|
To contribute, you can create pull request on the official repository at
|
|
`https://github.com/opf/openproject-documents`
|
|
|
|
Licence
|
|
-------
|
|
|
|
Copyright (C) 2009-2014 the OpenProject Foundation (OPF)
|
|
Copyright (C) 2006-2013 Jean-Philippe Lang
|
|
Copyright (C) 2010-2013 the ChiliProject Team
|
|
|
|
This plugin is licensed under the GNU GPL v3. See doc/COPYRIGHT.md and doc/GPL.txt for details.
|
|
|