Code Monkey home page Code Monkey logo

mokio's Introduction

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 [email protected], 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

mokio's People

Contributors

mateusz-z avatar tirlipirlik avatar mateusz-portka avatar adamstomski avatar matzet-bloom avatar justyna-zelman avatar gentoo-pl avatar versoft avatar mikoweb avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.