{"_id":"@afdev82/alchemy_cms_admin","_rev":"1-9d84db954808c79a9a53465ffedd9d4b","name":"@afdev82/alchemy_cms_admin","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@afdev82/alchemy_cms_admin","version":"0.2.0","description":"AlchemyCMS","browser":"package/admin.js","directories":{"lib":"package"},"scripts":{"test":"jest"},"repository":{"type":"git","url":"git+https://github.com/AlchemyCMS/alchemy_cms.git"},"keywords":[],"author":{"name":"Thomas von Deyen"},"license":"BSD-3-Clause","bugs":{"url":"https://github.com/AlchemyCMS/alchemy_cms/issues"},"homepage":"https://github.com/AlchemyCMS/alchemy_cms#readme","dependencies":{"sortablejs":"^1.10.2"},"devDependencies":{"@babel/core":"^7.9.6","@babel/preset-env":"^7.9.6","babel-jest":"^26.0.1","jest":"^25.2.7","prettier":"^2.0.2","xhr-mock":"^2.5.1"},"jest":{"globals":{"Alchemy":{}},"roots":["package"]},"gitHead":"9fa3d5e0f1ff1e46032725bfe7fa8c66dbc7cfcc","_id":"@afdev82/alchemy_cms_admin@0.2.0","_nodeVersion":"14.8.0","_npmVersion":"6.14.7","dist":{"integrity":"sha512-NF9LrUjiwDyrQJYPqsBHUarxk3fggodn8s5lZEjy4ByVM4iI+JEA5HHFLfLc/rEjxGLRlWwfJiSVCnE9hZVv4w==","shasum":"a29dc1fcaa2a5fea6fb9690c600f047f0c76a126","tarball":"https://registry.npmjs.org/@afdev82/alchemy_cms_admin/-/alchemy_cms_admin-0.2.0.tgz","fileCount":13,"unpackedSize":109487,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgvgPzCRA9TVsSAnZWagAA42IP+QB2QOMKfOfRIpK+vDsF\nyV9EplOsXHa6Fpoej7xe0WRv27zorIo3Gn7NGPG+07L7LhkU1TpoDJ+hTqqA\nhF/QDhbyTsqCiWd9RTCQR4kRxACHBny2Kv88vmY6X9Hwbm3/6yzAWDSZK+8D\nppmXs9IOkini+sXiIdeNO/C8a4dMoiQqM3l1OuHmGWVwhbmKRoUdYUhIidQa\nw6mOI4JzC0vBt3WHEMJG357ytOTgR3nOZe17ahqMrgXyHhPvVEwn6OOeDmS3\nJ1sPo52fYXNdai7NSw+ppHaYdIEene2nuliqk/kCRv6d7h8EvNmO/qV/hIAx\nxSQFKAEqJ5kcblTPbMhCmAhxfwrceMVahK8CPFK4thB9aqebY68c0B5er+7P\nxhNs3FzNT/9zorjL6dThYO5D+hHWfaY1r3zBQcbHSGpjNwoMPGaba0nOTTcU\nHQ1B3ESd5wm9YeZuvXsWtkO8S65/21FBi0qaeHcIOl2Rgcopk987cFL4B/mG\n2zT3YTTP3tHqVfwDrC/ZuCM61sIotaPqeTvbNkMT8P01JsrFof/YBDzHIaAm\nKiHBPwNjPoLIjM46uxqv8iDBWWWijZwDQvTvAw8fX55hSl7UdVVkar+P+x3b\n3Z/MVRtZShc5uP4f1UkmKb87bKdbyqx1l1dg+a5C5FQMTJDts2gDfQfaHREG\nEo0D\r\n=+aB+\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCuT8f8ZPsN++7d2qg0aT+etfWxTdnBa7aR2lzIds3LKQIhAOUXfvk9z20MXFl7VDqc9vx2TmVkpEqun9/yReaTTU96"}]},"_npmUser":{"name":"afdev82","email":"afdev82@gmail.com"},"maintainers":[{"name":"afdev82","email":"afdev82@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/alchemy_cms_admin_0.2.0_1623065587184_0.176593992220049"},"_hasShrinkwrap":false}},"time":{"created":"2021-06-07T11:33:07.130Z","0.2.0":"2021-06-07T11:33:07.322Z","modified":"2022-04-04T11:50:13.231Z"},"maintainers":[{"name":"afdev82","email":"afdev82@gmail.com"}],"description":"AlchemyCMS","homepage":"https://github.com/AlchemyCMS/alchemy_cms#readme","keywords":[],"repository":{"type":"git","url":"git+https://github.com/AlchemyCMS/alchemy_cms.git"},"author":{"name":"Thomas von Deyen"},"bugs":{"url":"https://github.com/AlchemyCMS/alchemy_cms/issues"},"license":"BSD-3-Clause","readme":"# AlchemyCMS\n\n[](http://badge.fury.io/rb/alchemy_cms)\n[](https://github.com/AlchemyCMS/alchemy_cms/actions)\n[](https://codeclimate.com/github/AlchemyCMS/alchemy_cms/maintainability)\n[](https://codeclimate.com/github/AlchemyCMS/alchemy_cms/test_coverage)\n[](https://depfu.com/github/AlchemyCMS/alchemy_cms?project_id=4600)\n\n[](https://slackin.alchemy-cms.com)\n[](https://houndci.com)\n\n[](#backers)\n[](#sponsors)\n\n![](\"./app/assets/images/alchemy/alchemy-logo.svg\")
\n\nAlchemy is an open source CMS engine written in Ruby on Rails.\n\nRead more about Alchemy on the [website](https://alchemy-cms.com) and in the [guidelines](https://guides.alchemy-cms.com).\n\n**CAUTION: This main branch is a development branch that *can* contain bugs. For productive environments you should use the [current Ruby gem version](https://rubygems.org/gems/alchemy_cms), or the [latest stable branch (5.0-stable)](https://github.com/AlchemyCMS/alchemy_cms/tree/5.0-stable).**\n\n\n## โ
Features\n\n- Flexible templating that separates content from markup\n- A rich RESTful API\n- Intuitive admin interface with live preview\n- Multi language and multi domain\n- SEO friendly urls\n- User Access Control\n- Build in contact form mailer\n- Attachments and downloads\n- On-the-fly image cropping and resizing\n- Extendable via Rails engines\n- Integrates into existing Rails Apps\n- Resourceful Rails admin\n- Flexible caching\n- Hostable on any Server that supports Ruby on Rails, a SQL Database and ImageMagick\n\n## ๐ฎ Demo\n\nDeploy your own free demo on Heroku\n\n[](https://heroku.com/deploy?template=https://github.com/AlchemyCMS/alchemy-demo)\n\nor visit the existing demo at https://alchemy-demo.herokuapp.com\n\n- Login: `demo`\n- Password: `demo123`\n\n## ๐ Rails Version\n\n**This version of AlchemyCMS runs with Rails 5.2 and Rails 6.0**\n\n* For a Rails 5.0 or 5.1 compatible version use the [`4.5-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/4.5-stable).\n* For a Rails 4.2 compatible version use the [`3.6-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/3.6-stable).\n* For a Rails 4.0/4.1 compatible version use the [`3.1-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/3.1-stable).\n* For a Rails 3.2 compatible version use the [`2.8-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/2.8-stable).\n* For a Rails 3.1 compatible version use the [`2.1-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/2.1-stable).\n* For a Rails 3.0 compatible version use the [`2.0-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/2.0-stable).\n* For a Rails 2.3 compatible version use the [`1.6-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/1.6-stable).\n\n\n## ๐ Ruby Version\n\nAlchemy runs with Ruby >= 2.3.0.\n\nFor a Ruby 2.2 compatible version use the [`4.1-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/4.1-stable).\n\nFor a Ruby 2.1 compatible version use the [`3.6-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/3.6-stable).\n\nFor a Ruby 2.0.0 compatible version use the [`3.2-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/3.2-stable).\n\nFor a Ruby 1.9.3 compatible version use the [`3.1-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/3.1-stable).\n\nFor a Ruby 1.8.7 compatible version use the [`2.3-stable` branch](https://github.com/AlchemyCMS/alchemy_cms/tree/2.3-stable).\n\n\n## โจ๏ธ Installation\n\n### Stand Alone Installation\n\nIf you do not have a Rails project yet or just want to check out Alchemy, then use this Rails template.\n\nMake sure you have Rails installed first:\n\n```\n$ gem install rails\n```\n\nThen create a new Rails project with:\n\n```\n$ rails new -m https://raw.githubusercontent.com/AlchemyCMS/rails-templates/master/all.rb \n```\n\nand follow the on screen instructions.\n\n### Manual Installation\n\nIf you want to manually install Alchemy into your Rails project follow these steps.\n\n#### Add the Alchemy gem:\n\nPut Alchemy into your `Gemfile` with:\n\n```\n$ bundle add alchemy_cms\n```\n\n#### Set the authentication user\n\nNow you have to decide, if you want to use your own user model or if you want to use\nthe Devise based user model that Alchemy provides and was extracted [into its own gem](https://github.com/AlchemyCMS/alchemy-devise).\n\n##### Use Alchemy user\n\nIf you don't have your own user class, you can use the Alchemy user model. Just add the following gem into your `Gemfile`:\n\n```\n$ bundle add alchemy-devise\n```\n\nThen run the `alchemy-devise` installer:\n\n```bash\n$ bin/rails g alchemy:devise:install\n```\n\n##### Use your User model\n\nIn order to use your own user model you need to tell Alchemy about it.\n\nThe best practice is to use an initializer:\n\n```ruby\n# config/initializers/alchemy.rb\nAlchemy.user_class_name = 'YourUserClass' # Defaults to 'User'\nAlchemy.current_user_method = 'current_admin_user' # Defaults to 'current_user'\nAlchemy.signup_path = '/your/signup/path' # Defaults to '/signup'\nAlchemy.login_path = '/your/login/path' # Defaults to '/login'\nAlchemy.logout_path = '/your/logout/path' # Defaults to '/logout'\nAlchemy.logout_method = 'http_verb_for_logout' # Defaults to 'delete'\n```\n\nThe only thing Alchemy needs to know from your user class is the `alchemy_roles` method.\n\nThis method has to return an `Array` (or `ActiveRecord::Relation`) with at least one of the following roles: `member`, `author`, `editor`, `admin`.\n\n##### Example\n\n```ruby\n# app/models/user.rb\n\ndef alchemy_roles\n if admin?\n %w(admin)\n end\nend\n```\n\nPlease follow [this guide](http://guides.alchemy-cms.com/stable/custom_authentication.html) for further instructions on how to customize your user class even more.\n\n#### 4. Install Alchemy into your app:\n\n**After** you set the user model you need to run the Alchemy install task:\n\n```bash\n$ bin/rails alchemy:install\n```\n\nNow everything should be set up and you should be able to visit the Alchemy Dashboard at:\n\n\n\n*) Use your custom path if you mounted Alchemy at something else then `'/'`\n\n\n## ๐ Customization\n\nAlchemy has very flexible ways to organize and manage content. Please be sure to read [the introduction guide](https://guides.alchemy-cms.com/about.html) in order to understand the basic idea of how Alchemy works.\n\n\n### Custom Controllers\n\nBeginning with Alchemy 3.1 we do not patch the `ApplicationController` anymore. If you have controllers that loads Alchemy content or uses Alchemy helpers in the views (i.e. `render_menu` or `render_elements`) you can either inherit from `Alchemy::BaseController` or you `include Alchemy::ControllerActions` in your controller (**that's the recommended way**).\n\n### Custom admin interface routing\n\nBy default, Alchemy Dashboard is accessible at . You can change this by setting `Alchemy.admin_path` and `Alchemy.admin_constraints`.\n\nFor example, these settings:\n\n```ruby\n# config/initializers/alchemy.rb\n\nAlchemy.admin_path = 'backend'\nAlchemy.admin_constraints = {subdomain: 'hidden'}\n```\n\nwill move the dashboard to .\n\n### Picture caching\n\nAlchemy uses the Dragonfly gem to render pictures on-the-fly.\n\nTo make this as performant as possible the rendered picture gets stored into `public/pictures` so the web server can pick up the file and serve it without hitting the Rails process at all.\n\nThis may or may not what you want. Especially for multi server setups you eventually want to use something like S3.\n\nPlease follow the guidelines about picture caching on the Dragonfly homepage for further instructions:\n\nhttp://markevans.github.io/dragonfly/cache\n\nWe also provide an [extension for Cloudinary](https://github.com/AlchemyCMS/alchemy_cloudinary)\n\n## ๐ Localization\n\nAlchemy ships with one default English translation for the admin interface. If you want to use the admin interface in other languages please have a look at the [`alchemy_i18n` project](https://github.com/AlchemyCMS/alchemy_i18n).\n\n## โจ Upgrading\n\nWe, the Alchemy team, take upgrades very seriously and we try to make them as smooth as possible. Therefore we have build an upgrade task, that tries to automate the upgrade procedure as much as possible.\n\nThat's why after the Alchemy gem has been updated, with explicit call to:\n\n```bash\n$ bundle update alchemy_cms\n```\n\nyou should **always run the upgrader**:\n\n```bash\n$ bin/rake alchemy:upgrade\n```\n\nAlchemy will print out useful information after running the automated tasks that help a smooth upgrade path.\nSo please **take your time and read them**.\n\nAlways be sure to keep an eye on the `config/alchemy/config.yml.defaults` file and update your `config/alchemy/config.yml` accordingly.\n\nAlso, `git diff` is your friend.\n\n### Customize the upgrade preparation\n\nThe Alchemy upgrader comes prepared with several rake tasks in a specific order.\nThis is sometimes not what you want or could even break upgrades.\nIn order to customize the upgrade preparation process you can instead run each of the tasks on their own.\n\n```bash\n$ bin/rake alchemy:install:migrations\n$ bin/rake db:migrate\n$ bin/rake alchemy:db:seed\n$ bin/rake alchemy:upgrade:config\n$ bin/rake alchemy:upgrade:run\n```\n\n**WARNING:** This is only recommended, if you have problems with the default `rake alchemy:upgrade` task and need to\nrepair your data in between. The upgrader depends on these upgrade tasks running in this specific order, otherwise\nwe can't ensure smooth upgrades for you.\n\n### Run an individual upgrade\n\nYou can also run an individual upgrade on its own:\n\n```bash\n$ bin/rake -T alchemy:upgrade\n```\n\nprovides you with a list of each upgrade you can run individually.\n\n#### Example\n\n```bash\n$ bin/rake alchemy:upgrade:4.1\n```\n\nruns only the Alchemy 4.1 upgrade\n\n## ๐ Deployment\n\nAlchemy has an official Capistrano extension which takes care of everything you need to deploy an Alchemy site.\n\nPlease use [capistrano-alchemy](https://github.com/AlchemyCMS/capistrano-alchemy), if you want to deploy with Capistrano.\n\n### Without Capistrano\n\nIf you don't use Capistrano you have to **make sure** that the `uploads`, `tmp/cache/assets`, `public/assets` and `public/pictures` folders get **shared between deployments**, otherwise you **will loose data**. No, not really, but you know, just keep them in sync.\n\n\n## ๐ง Testing\n\nIf you want to contribute to Alchemy ([and we encourage you to do so](CONTRIBUTING.md)) we have a strong test suite that helps you to not break anything.\n\n### Preparation\n\nFirst of all you need to clone your fork to your local development machine. Then you need to install the dependencies with bundler.\n\n```bash\n$ bundle install\n```\n\nTo prepare the tests of your Alchemy fork please make sure to run the preparation task:\n\n```bash\n$ bundle exec rake alchemy:spec:prepare\n```\n\nto set up the database for testing.\n\n### Run your tests with:\n\n```bash\n$ bundle exec rspec\n```\n\n**Alternatively** you can just run*:\n\n```bash\n$ bundle exec rake\n```\n\n*) This default task executes the database preparations and runs all defined test cases.\n\n### Start the dummy app\n\nYou can even start the dummy app and use it to manually test your changes with:\n\n```bash\n$ cd spec/dummy\n$ bin/setup\n$ bin/rails s\n```\n\n\n## ๐ฆ Releasing\n\n### Update the changelog\n\n```bash\n$ export GITHUB_ACCESS_TOKEN=...\n$ PREVIOUS_VERSION=4.1.0 bundle exec rake alchemy:changelog:update\n```\n\n### Release a new version\n\n```bash\n$ bundle exec rake release\n```\n\n\n## โGetting Help\n\n* Read the guidelines: https://guides.alchemy-cms.com.\n* Read the documentation: https://www.rubydoc.info/github/AlchemyCMS/alchemy_cms\n* If you think you found a bug please use the [issue tracker on Github](https://github.com/AlchemyCMS/alchemy_cms/issues).\n* For questions about general usage please use [Stack Overflow](http://stackoverflow.com/questions/tagged/alchemy-cms) or the [Slack](https://slackin.alchemy-cms.com).\n* New features should be discussed on our [Trello Board](https://trello.com/alchemycms).\n\n**PLEASE** don't use the Github issues for feature requests. If you want to contribute to Alchemy please [read the contribution guidelines](CONTRIBUTING.md) before doing so.\n\n\n## ๐ Resources\n\n* Homepage: \n* Live-Demo: (user: demo, password: demo123)\n* API Documentation: \n* Issue-Tracker: \n* Sourcecode: \n* Slack: \n* Twitter: \n\n\n## โ๏ธ Authors\n\n* Thomas von Deyen: \n* Robin Bรถning: \n* Marc Schettke: \n* Hendrik Mans: \n* Carsten Fregin: \n\n\n## ๐
Contributors\n\nThis project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].\n![](\"https://opencollective.com/alchemy_cms/contributors.svg?width=890&button=false\")
\n\n\n## ๐ต Backers\n\nThank you to all our backers! ๐ [[Become a backer](https://opencollective.com/alchemy_cms#backer)]\n\n![](\"https://opencollective.com/alchemy_cms/backers.svg?width=890\")
\n\n\n## ๐ฐ Sponsors\n\nSupport this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/alchemy_cms#sponsor)]\n\n![](\"https://opencollective.com/alchemy_cms/sponsor/0/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/1/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/2/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/3/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/4/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/5/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/6/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/7/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/8/avatar.svg\")
\n![](\"https://opencollective.com/alchemy_cms/sponsor/9/avatar.svg\")
\n\n\n\n## ๐ License\n\n[BSD-3-Clause](LICENSE)\n\n\n## ๐ข Spread the love\n\nIf you like Alchemy, please help us to spread the word about Alchemy and star this repo [on GitHub](https://github.com/AlchemyCMS/alchemy_cms), upvote it [on The Ruby Toolbox](https://www.ruby-toolbox.com/projects/alchemy_cms), mention us [on Twitter](https://twitter.com/alchemy_cms).\n\nThat will help us to keep Alchemy awesome.\n\nThank you!\n\n## โค๏ธ\n","readmeFilename":"README.md"}