Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
app
 
 
bin
 
 
 
 
 
 
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Mokio CMS <Versoft>

In short:

MOKIO is open source CMS compatible with rails 6.0.1 and ruby 2.6.5.

Instalation:

  1. Add gem mokio to Gemfile in your project
  2. Run bundle install
  3. Run rake mokio:install
  4. Ensure is add the following line added to config/routes.rb mount Mokio::Engine => "/backend"
  5. Start rails server rails s and open http://localhost:3000/backend
  6. Your login is admin@bloomnet.eu, password admin
  7. Remember to change this sample credentials!

Test by RSpec

Run all tests in main directory using command: rspec To suppress warnings use: rspec --deprecation-out /dev/null Details for configure Spec Dummy App for properly working tests.

Usage:

Overriding Mokio js

In case you need to add some custom logic to Mokio panel's javascript, run:

rails mokio:add_custom_js

in your project's folder.

This task will create custom.js file in under assets/javascripts/backend folder, which will be imported in the panel.

Adding gallery to your custom model

In your model:

Include Gallery

include Mokio::CustomGallery

Change DataFile type if needed (Mokio::Photo is set by default)

def default_data_file
  # Available options:
  # Mokio::Photo
  # Mokio::Youtube
end

Optionaly add gallery title

def gallery_title
  "Gallery title"
end

More docs:

More docs soon!


Secure login with Google reCAPTCHA v3

To turn on login with reCAPTCHA go to config/mokio.rb and update configs:

  config.mokio_login_with_recaptcha = true
  config.mokio_login_recaptcha_site_key = 'KEY'
  config.mokio_login_recaptcha_secret_key = 'KEY'
  config.mokio_login_recaptcha_score = 0.9

More info: reCAPTCHA v3

Gems and sample_app:

Sample app using Mokio CMS

See https://github.com/versoft/mokio_sample_app

Gems dedicated for Mokio CMS:

mokio_skins https://github.com/versoft/mokio_skins

Tutorials, documentation & useful tips

See http://www.mokio.org/support

Known issues

To use Mokio::MovGallery you have to add this to your Gemfile:

gem 'youtube_it', github: 'LiveWorld/youtube_it'

because original version of youtube_it gem is not maintained anymore and uncompatibile with Rails 5.

Migrating your app to Mokio >= 2.7.14

Please add mount Ckeditor::Engine => '/ckeditor' to Rails.application.routes block, since Ckeditor mount has been moved to mokio:install task.

Description

Mokio is a Content Management System that allows creation of sophisticated websites. It consists maily of administration panel for your desired website. It provides the following types of content: Article (piece of text with pictures, lists, links, etc.), Picture Gallery (easily managed article with a number of photos - thumbs and edition provided), Movie Gallery (article with links to Dailymotion, Vimeo and Youtube movies - thumbs and edition provided), Contact Page with Google map and contact form.

Apart from content it is possible to manage menu structure of your website for each language and defined position (part of the screen).

If this is not enough for what you need, you can also include pieces of HTML code that should be shared by some (or all) subpages - called HTML Blocks. You can define on which part of the page, these blocks should be displayed. Mokio provides also administration panel for javascripts, languages and backend users.

Beside Mokio itself, there are various gems dedicated for Mokio, that extends its core functionality.

Licence

GNU AGPLv3: http://www.gnu.org/licenses/agpl-3.0.html