Skip to content

Latest commit

 

History

History
executable file
·
78 lines (43 loc) · 3.11 KB

README.md

File metadata and controls

executable file
·
78 lines (43 loc) · 3.11 KB

OJS-FidusWriter

OJS-FidusWriter is an Open Journal Systems (OJS) plugin to connect an OJS instance with Fidus Writer to from an integrated publishing system. This plugin has to be combined with the FidusWriter-OJS plugin for Fidus Writer.

Project page: https://www.fiduswriter.org/ojs-integration/

Installation:

  1. Follow the instructions for the FidusWriter-OJS plugin to install Fidus Writer and the connector on the Fidus Writer side: https://github.com/fiduswriter/fiduswriter-ojs

  2. Install OJS

To install OJS please follow the instructions at https://github.com/pkp/ojs/ . This plugin is currently compatible with OJS 3.1.2, so check out the stable-3_1_2 branch.

  1. Setup at least two journals on the OJS instance

This step is required to make the global settings show in the OJS menus.

  1. Download plugin files

Download and copy the plugin files from github into plugins/generic/fidusWriter inside your OJS folder. Create the folder if it does not exist. You can achieve this by running these commands:

cd plugins/generic/
git clone https://github.com/fiduswriter/ojs-fiduswriter.git fidusWriter
cd ../..
  1. Register plugin with OJS by running:
php lib/pkp/tools/installPluginVersion.php plugins/generic/fidusWriter/version.xml
  1. Activate plugin in OJS

Enable the plugin via the OJS website interface:

Open the OJS interface and select "ENABLE" under the settings "Fidus Writer Integration Plugin" under the following routes:

setting > website > plugins

  1. Configure the API key in OJS

Come up with an API Key to allow secure communications between Fidus Writer and OJS. This is just a single long text string that you should not share with anyone that will need to be entered in the configurations of Fidus Writer and OJS. Be cautious: The key allows automatic login into Fidus Writer and OJS in various ways, so do not share it!

To set the key in OJS, go to the settings of the Fidus Writer integration plugin under the following routes:

setting > website > plugins -> Fidus Writer Integration plugin (triangle to left) -> Settings -> Enter API key -> Save.

  1. Activate connection on Fidus Writer side

Enter the administration interface at your Fidus Writer installation (http://myserver.com/admin).

In the section "Custom views" click on "Register journal". Enter the URL and API Key (from step 4) of your OJS installation.

Credits

This plugin has been developed by the Opening Scolarly Communications in the Social Sciences (OSCOSS) project, financed by the German Research Foundation (DFG) and executed by the University of Bonn and GESIS – Leibniz Institute for the Social Sciences.

Lead Developer: Afshin Sadeghi

License

This software is released under the the GNU General Public License v2.0.

See the file License.md included with this distribution for the terms of this license.

Third parties are welcome to modify and redistribute the plugin in entirety or parts according to the terms of this license. We also welcome patches for improvements or bug fixes to the software.