spina-admin-journal 1.0.0.rc2 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9dfe8f35c6a45f02481c7259fb3a6d5eba37cae6c7725c5e82f7a5658a340a7
-  data.tar.gz: 4daa82dba66f3f02c473db5d8a165934b68241af3069ddae1c509b246e6ae936
+  metadata.gz: f786acd82a7df514c811bd3fd8fd06220b030d58858b1897bde326f62ee03d3c
+  data.tar.gz: 8b02e8903963f11402ce612ac7a53c77c851dc17ba5425edf333eab8c875ab07
 SHA512:
-  metadata.gz: 56e6ce7ac600354e6dd0c2bfba6d7b702661ecd6da9ac6666f44890f62805f3853bfa14c81475a33cf4e84350ed20f446d7e6e3beb2833ea73e1133057acc036
-  data.tar.gz: f6ae39891fe012f049cfedb9517ec2a386de90b82c947db39f46e24eb783c94bee25cbc0caf37a52c0f5b9925a6d7318d79ef2aab27aecf7da23acb89872576b
+  metadata.gz: 50c4507b1747a4a17db2b16836626f72cc8d149676af9ef9e442daa81e192af21bce6c913168e8f570474d2f0052b5cc5df1fde1c8e4c3d963fc85f07ac66eb0
+  data.tar.gz: 4f8a96788318d91f69911489a979a258c87020690e3a6e6f5ec006911a140388a77056e9e2ff83434eedbfc8944437bbf4c445b9b4c088c1af8acf60c724c877

data/README.md

@@ -1,5 +1,9 @@
 # Spina::Admin::Journal
 
+*Journal* is a plugin for [Spina](https://www.spinacms.com/) that provides a fully-fledged journal management package, intended to provide a more streamlined, easy-to-use, modern alternative to [OJS](https://pkp.sfu.ca/ojs/).
+
+Spina is a content management system built in [Ruby on Rails](http://rubyonrails.org/). *Journal* augments Spina by providing an admin interface for managing an academic journal.
+
 ![Rails tests](https://github.com/louis-vs/spina-admin-journal/workflows/Verify/badge.svg?branch=master&event=push)
 [![codecov](https://codecov.io/gh/louis-vs/spina-admin-journal/branch/master/graph/badge.svg?token=9TZ9QGGLAH)](https://codecov.io/gh/louis-vs/spina-admin-journal)
 [![CodeFactor](https://www.codefactor.io/repository/github/louis-vs/spina-admin-journal/badge)](https://www.codefactor.io/repository/github/louis-vs/spina-admin-journal)
@@ -7,69 +11,48 @@
 [![Code quality: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/louis-vs/spina-admin-journal.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/louis-vs/spina-admin-journal/context:javascript)
 [![Inline docs](http://inch-ci.org/github/louis-vs/spina-admin-journal.svg?branch=master)](http://inch-ci.org/github/louis-vs/spina-admin-journal)
 
-*Journal* is a plugin for [Spina](https://www.spinacms.com/), a content management system built in [Ruby on Rails](http://rubyonrails.org/). *Journal* augments Spina by providing an admin interface for managing an academic journal.
-
-## Usage
-
-The plugin adds two menus to Spina's primary navigation:
-
-* **Journal settings** provides access to global properties of the journal. It is divided into 3 submenus:
-  * **Journal** allows you to change the name of the journal.
-  * **Institutions** allows you to add institutions, to which authors can be affiliated.
-  * **Authors** allows you to add authors, who can then be added to articles.
-* The **journal content** menu will be named after the journal as specified in Journal Settings. It provides a means of editing the content of the journal and is divided into three submenus:
-  * **Volumes** allows you to add and remove volumes of the journal, and edit their respective issues.
-  * **Issues** allows you to add, edit and remove issues of particular volumes of the journal, and edit their respective articles.
-  * **Articles** allows you to add, edit and remove articles belonging to particular issues.
+## Features
 
-The plugin does not provide any public-facing frontend. However, an example implementation can be found at **[TBC]**.
+The journal plugin covers many of the needs of a professional online journal publication, including:
 
-**NB this plugin is currently a work in progress**: please wait until an official release to use this plugin in production.
+- Simple, responsive, intuitive interface that builds upon Spina's own.
+- Seamlessly integrate published content with other information about the journal.
+- Manage volumes, issues, articles and authors in a highly structured and organised manner.
+- Keep track of individual authors with multiple affiliations, e.g. if they change name or institution, connecting with [ORCID](https://orcid.org/).
 
-## Installation
-
-### From scratch
-
-Make sure you have a working installation of Ruby on Rails 6.1. You can find a setup guide [here](https://guides.rubyonrails.org/getting_started.html).
-
-Then run:
-
-```bash
-$ rails new your-app --database=postgresql
-$ cd your-app
-$ bin/rails db:create
-$ bin/rails active_storage:install
-```
+Currently, a submissions management system is not included, but this is planned for a future release. This will allow you to manage the submissions process for the journal in a streamlined manner in parallel to publication.
 
-Add this line to your new application's Gemfile:
+## Usage
 
-```ruby
-gem 'spina', '~> 2.0'
-```
+The plugin adds two menus to Spina's primary navigation:
 
-And then execute:
+- **Journal settings** provides access to global properties of the journal. It is divided into 3 submenus:
+  - **Journal** allows you to change metadata such as the name of the journal, as well as content that will appear on the journal homepage.
+  - **Institutions** allows you to add institutions, to which authors can be affiliated.
+  - **Authors** allows you to add authors and their affiliations, which can then be added to articles.
+  - **Licences** allows you to add licences and association information, which can be associated with individual articles, representing the licence under which the content is released.
+- The **journal content** menu will be named after the journal as specified in Journal Settings. It provides a means of editing the content of the journal and is divided into three submenus:
+  - **Volumes** allows you to add and remove volumes of the journal, and edit their respective issues.
+  - **Issues** allows you to add, edit and remove issues of particular volumes of the journal, and edit their respective articles.
+  - **Articles** allows you to add, edit and remove articles belonging to particular issues.
 
-```bash
-$ bundle install
-```
+**NB:** This release of the plugin does not provide any public-facing frontend or Spina theme. An example implementation can be found within the [Conferences Primer Theme](https://github.com/louis-vs/spina-conferences-primer_theme-fork). Note that this theme also contains frontends for two other Spina plugins, [Spina Conferences Blog](https://github.com/louis-vs/spina-admin-conferences-blog) and [Spina Admin Conferences](https://github.com/louis-vs/spina-admin-conferences-fork/). You can use the theme in your project as is, or copy whichever parts of the code you need.
 
-Run the Spina install generator:
+A dedicated journal theme, coupled with an automatic installer, is being planned. A system to manage submissions is also on the roadmap.
 
-```bash
-$ bin/rails g spina:install
-```
+## Installation
 
-And follow the prompts. Once this is complete, follow the instructions below.
+Make sure you have a working installation of Ruby on Rails 7. You can find a setup guide [here](https://guides.rubyonrails.org/getting_started.html).
 
-### For existing Spina installations
+You then need to install Spina, following the guide [on the Spina website](https://spinacms.com/docs).
 
-Add this line to your application's Gemfile:
+To install the plugin, add this line to your application's Gemfile:
 
 ```ruby
-gem 'spina-admin-journal', '~> 0.1'
+gem 'spina-admin-journal', '~> 1.0'
 ```
 
-And then execute:
+Then execute:
 
 ```bash
 $ bundle install
@@ -78,7 +61,7 @@ $ bundle install
 You'll then need to install and run the migrations for the journal:
 
 ```bash
-$ bin/rails spina_admin_journal_engine:install:migrations
+$ bin/rails spina_admin_journal:install:migrations
 $ bin/rails db:migrate
 ```
 
@@ -94,6 +77,11 @@ You can manually populate the database from within the app, or alternatively you
 
 Bug reports and feature requests are welcome in the [Issues](https://github.com/louis-vs/spina-admin-journal/issues) section. Translations are also very welcome!
 
+### Planned features
+
+- [ ] Submissions management
+- [ ] Translations
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/controllers/spina/admin/journal/articles_controller.rb

@@ -25,7 +25,7 @@ module Spina
 
         before_action :set_breadcrumb
         before_action :set_tabs, except: %i[index destroy sort]
-        before_action :set_article, only: %i[edit update destroy]
+        before_action :set_article, only: %i[edit view_authors update destroy]
         before_action :set_parts_attributes, only: %i[new edit]
         before_action :build_parts, only: %i[edit]
 
@@ -43,6 +43,10 @@ module Spina
 
         def edit; end
 
+        def view_authors
+          render layout: false
+        end
+
         def create # rubocop:disable Metrics/AbcSize
           @article = Article.new(article_params)
           sister_articles = Article.where(issue: @article.issue_id)

data/app/controllers/spina/admin/journal/authors_controller.rb

@@ -7,7 +7,7 @@ module Spina
       class AuthorsController < ApplicationController
         before_action :set_breadcrumb
         before_action :set_tabs, except: %i[index destroy]
-        before_action :set_author, only: %i[edit update destroy]
+        before_action :set_author, only: %i[edit view_articles update destroy]
 
         admin_section :journal_settings
 
@@ -23,6 +23,10 @@ module Spina
 
         def edit; end
 
+        def view_articles
+          render layout: false
+        end
+
         def create
           @author = Author.new(modified_params)
           if @author.save

data/app/controllers/spina/admin/journal/institutions_controller.rb

@@ -7,7 +7,7 @@ module Spina
       class InstitutionsController < ApplicationController
         before_action :set_breadcrumb
         before_action :set_tabs, except: %i[index destroy]
-        before_action :set_institution, only: %i[edit update destroy]
+        before_action :set_institution, only: %i[edit view_affiliations update destroy]
 
         admin_section :journal_settings
 
@@ -22,6 +22,10 @@ module Spina
 
         def edit; end
 
+        def view_affiliations
+          render layout: false
+        end
+
         def create
           @institution = Institution.new(institution_params)
 

data/app/controllers/spina/admin/journal/issues_controller.rb

@@ -25,8 +25,8 @@ module Spina
 
         before_action :set_breadcrumb
         before_action :set_tabs, except: %i[index destroy sort]
-        before_action :set_issue, only: %i[edit update destroy]
-        before_action :set_articles, only: %i[edit update]
+        before_action :set_issue, only: %i[edit view_articles update destroy]
+        before_action :set_articles, only: %i[edit view_articles update]
         before_action :set_parts_attributes, only: %i[new edit]
         before_action :build_parts, only: %i[edit]
 
@@ -48,6 +48,10 @@ module Spina
           add_breadcrumb t('spina.admin.journal.issues.issue_number', number: @issue.number)
         end
 
+        def view_articles
+          render layout: false
+        end
+
         def create # rubocop:disable Metrics/AbcSize
           @issue = Issue.new(issue_params)
           sister_issues = Issue.where(volume: @issue.volume_id)

data/app/controllers/spina/admin/journal/volumes_controller.rb

@@ -7,7 +7,7 @@ module Spina
       class VolumesController < ApplicationController
         before_action :set_breadcrumb
         before_action :set_tabs, except: %i[index destroy]
-        before_action :set_volume, only: %i[edit destroy]
+        before_action :set_volume, only: %i[edit view_issues destroy]
 
         admin_section :journal
 
@@ -17,6 +17,10 @@ module Spina
 
         def edit; end
 
+        def view_issues
+          render layout: false
+        end
+
         def new
           create
         end

data/app/views/spina/admin/journal/articles/_form_authors.html.haml

@@ -1,2 +1,3 @@
-.-mt-4.md:-mt-8
-= render Spina::Admin::Journal::AuthorshipsListComponent.new(authorships: @article.authorships.sorted_within_article, sortable: true)
+- if @article.persisted?
+  .-mt-4.md:-mt-8
+    %turbo-frame#article_authors{ src: spina.view_authors_admin_journal_article_path(@article), loading: 'lazy' }

data/app/views/spina/admin/journal/articles/view_authors.html.haml

@@ -0,0 +1,2 @@
+%turbo-frame#article_authors
+  = render Spina::Admin::Journal::AuthorshipsListComponent.new(authorships: @article.authorships.sorted_within_article, sortable: true)

data/app/views/spina/admin/journal/authors/_form_articles.html.haml

@@ -1,2 +1,3 @@
-.-mt-4.md:-mt-8
-= render Spina::Admin::Journal::ArticlesListComponent.new(articles: @author.affiliations.reduce([]) { |memo, affiliation| memo << affiliation.articles.to_a }.flatten )
+- if @author.persisted?
+  .-mt-4.md:-mt-8
+  %turbo-frame#author_articles{ src: spina.view_articles_admin_journal_author_path(@author), loading: 'lazy' }

data/app/views/spina/admin/journal/authors/view_articles.html.haml

@@ -0,0 +1,2 @@
+%turbo-frame#author_articles
+  = render Spina::Admin::Journal::ArticlesListComponent.new(articles: @author.affiliations.reduce([]) { |memo, affiliation| memo << affiliation.articles.to_a }.flatten )

data/app/views/spina/admin/journal/institutions/_form_view_affiliations.html.haml

@@ -1,2 +1,3 @@
-.-mt-4.md:-mt-8
-= render Spina::Admin::Journal::AffiliationsListComponent.new(affiliations: @institution.affiliations.sorted)
+- if @institution.persisted?
+  .-mt-4.md:-mt-8
+  %turbo-frame#institution_affiliations{ src: spina.view_affiliations_admin_journal_institution_path(@institution), loading: 'lazy' }

data/app/views/spina/admin/journal/institutions/view_affiliations.html.haml

@@ -0,0 +1,2 @@
+%turbo-frame#institution_affiliations
+  = render Spina::Admin::Journal::AffiliationsListComponent.new(affiliations: @institution.affiliations.sorted)

data/app/views/spina/admin/journal/issues/_form_articles.html.haml

@@ -1,2 +1,3 @@
-.-mt-4.md:-mt-8
-= render Spina::Admin::Journal::ArticlesListComponent.new(articles: @issue.articles, sortable: true)
+- if @issue.persisted?
+  .-mt-4.md:-mt-8
+    %turbo-frame#issue_articles{ src: spina.view_articles_admin_journal_issue_path(@issue), loading: 'lazy' }

data/app/views/spina/admin/journal/issues/view_articles.html.haml

@@ -0,0 +1,3 @@
+%turbo-frame#issue_articles
+  = render Spina::Admin::Journal::ArticlesListComponent.new(articles: @issue.articles, sortable: true)
+

data/app/views/spina/admin/journal/volumes/_form_issues.html.haml

@@ -1,2 +1,2 @@
 .-mt-4.md:-mt-8
-= render Spina::Admin::Journal::IssuesListComponent.new(issues: @volume.issues, sortable: true)
+%turbo-frame#volume_issues{ src: spina.view_issues_admin_journal_volume_path(@volume), loading: 'lazy' }

data/app/views/spina/admin/journal/volumes/view_issues.html.haml

@@ -0,0 +1,2 @@
+%turbo-frame#volume_issues
+  = render Spina::Admin::Journal::IssuesListComponent.new(issues: @volume.issues, sortable: true)

data/config/routes.rb

@@ -6,18 +6,38 @@ Spina::Engine.routes.draw do
       resources :journals, only: %i[edit update destroy]
       resources :volumes, except: %i[show update] do
         post 'sort/:journal_id' => 'volumes#sort', as: :sort, on: :collection
+
+        member do
+          get :view_issues
+        end
       end
       resources :issues, except: %i[show] do
         post 'sort/:volume_id' => 'issues#sort', as: :sort, on: :collection
+
+        member do
+          get :view_articles
+        end
       end
       resources :articles, except: %i[show] do
         post 'sort/:issue_id' => 'articles#sort', as: :sort, on: :collection
+
+        member do
+          get :view_authors
+        end
       end
       resources :authors, except: %i[show] do
         post 'sort/:article_id' => 'authors#sort', as: :sort, on: :collection
+
+        member do
+          get :view_articles
+        end
       end
 
-      resources :institutions, except: %i[show]
+      resources :institutions, except: %i[show] do
+        member do
+          get :view_affiliations
+        end
+      end
       resources :licences, except: %i[show]
     end
   end

data/lib/spina/admin/journal/version.rb

@@ -3,7 +3,7 @@
 module Spina
   module Admin
     module Journal
-      VERSION = '1.0.0.rc2'
+      VERSION = '1.0.0.rc3'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spina-admin-journal
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc2
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Louis Van Steene
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-30 00:00:00.000000000 Z
+date: 2022-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: haml-rails
@@ -305,6 +305,7 @@ files:
 - app/views/spina/admin/journal/articles/edit.html.haml
 - app/views/spina/admin/journal/articles/index.html.haml
 - app/views/spina/admin/journal/articles/new.html.haml
+- app/views/spina/admin/journal/articles/view_authors.html.haml
 - app/views/spina/admin/journal/authors/_form.html.haml
 - app/views/spina/admin/journal/authors/_form_affiliation.html.haml
 - app/views/spina/admin/journal/authors/_form_articles.html.haml
@@ -312,18 +313,21 @@ files:
 - app/views/spina/admin/journal/authors/edit.html.haml
 - app/views/spina/admin/journal/authors/index.html.haml
 - app/views/spina/admin/journal/authors/new.html.haml
+- app/views/spina/admin/journal/authors/view_articles.html.haml
 - app/views/spina/admin/journal/institutions/_form.html.haml
 - app/views/spina/admin/journal/institutions/_form_details.html.haml
 - app/views/spina/admin/journal/institutions/_form_view_affiliations.html.haml
 - app/views/spina/admin/journal/institutions/edit.html.haml
 - app/views/spina/admin/journal/institutions/index.html.haml
 - app/views/spina/admin/journal/institutions/new.html.haml
+- app/views/spina/admin/journal/institutions/view_affiliations.html.haml
 - app/views/spina/admin/journal/issues/_form.html.haml
 - app/views/spina/admin/journal/issues/_form_articles.html.haml
 - app/views/spina/admin/journal/issues/_form_details.html.haml
 - app/views/spina/admin/journal/issues/edit.html.haml
 - app/views/spina/admin/journal/issues/index.html.haml
 - app/views/spina/admin/journal/issues/new.html.haml
+- app/views/spina/admin/journal/issues/view_articles.html.haml
 - app/views/spina/admin/journal/journals/_form.html.haml
 - app/views/spina/admin/journal/journals/edit.html.haml
 - app/views/spina/admin/journal/journals/new.html.haml
@@ -337,6 +341,7 @@ files:
 - app/views/spina/admin/journal/volumes/edit.html.haml
 - app/views/spina/admin/journal/volumes/index.html.haml
 - app/views/spina/admin/journal/volumes/new.html.haml
+- app/views/spina/admin/journal/volumes/view_issues.html.haml
 - app/views/spina/admin/parts/admin/journal/page_ranges/_form.html.haml
 - config/locales/en.yml
 - config/routes.rb