Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Documentation] Add CMS integration cookbook #9155

Merged
merged 4 commits into from
Feb 12, 2018
Merged

[Documentation] Add CMS integration cookbook #9155

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
f4495df
Add CMS integration cookbook
bitbager Feb 6, 2018
ac5d95b
Apply doc standards
bitbager Feb 7, 2018
062d4f2
Apply doc standards
bitbager Feb 7, 2018
a47db32
Adjust to doc standards, fix broken links
bitbager Feb 9, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/cookbook/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ Shop
shop/taxons-menu
shop/embedding-products
shop/facebook-login
shop/cms

.. include:: /cookbook/shop/map.rst.inc

Expand Down
45 changes: 45 additions & 0 deletions docs/cookbook/shop/cms.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
How to manage content in Sylius?
=================================

Why do you need content management system?
--------------------------------------------

Content management is one of the most important business aspects of modern eCommerce apps.
Providing store updates like new blog pages, banners and promotion images is responsible for building the conversion rate
either for new and existing clients.

Content management in Sylius
-----------------------------------

Default Sylius standard app does not come with a content management system. Don’t worry - our community has taken care of it. As Sylius does have an awesome dev oriented plugin environment,
our friends from `BitBag <https://bitbag.shop>`_ decided to develop their flexible CMS module. You can find it on `their GitHub <https://github.com/BitBagCommerce/SyliusCmsPlugin>`_.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more. 

Sylius standard application does not come with a content management system. Although as Sylius does have a convenient plugin development environment,
the `BitBag <https://bitbag.shop>`_ contributors have decided to develop a flexible CMS module. You can find it `here, on their GitHub <https://github.com/BitBagCommerce/SyliusCmsPlugin>`_.

And please break the lines a bit :)


.. tip::

Check their `GitHub <https://github.com/BitBagCommerce>`_ for more awesome plugins like payment gateways integrations, shipment management and many more. Don't forget to leave a star if you liked their work!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the plugins are already listed on this page: http://docs.sylius.org/en/latest/plugins/index.html#the-official-list-of-plugins No need to mention it here. Cookbooks are focusing on solving certain problems, plugin advertisements are rather clutter here.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I feel a little bit overwhelmed with amount of BitBag links in this cookbook 🎉

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👌


.. tip::

The whole plugin has its own `demo page <https://github.com/BitBagCommerce>`_ with specific use cases. You can access the `admin panel <https://github.com/BitBagCommerce>`_
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't look like a demo page or admin panel

with ``login: sylius, password: sylius`` credentials.

Inside the plugin, you will find:

* HTML, image and text blocks you can place in each Twig template
* Page resources
* Sections which you can use to create a blog, customer information, etc.
* FAQ module

What is the most awesome thing about this plugin is that you can customize it for your specific needs like you do with each * :doc:`Sylius model </customization/model>`.

Installation & usage
-----------------------------------
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

too long line of -


Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And btw can we add here a sample guide on the plugin usage? Adding one simple block or sth?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be better to leave the usage inside the README as many things change inside the plugin core.

Find out more about how to use the plugin on `GitHub <https://github.com/BitBagCommerce>`_.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The link is wrong I suppose.


Learn more
----------

* :doc:`How to create a plugin for Sylius? </plugins/creating-plugin>`
* `BitBag plugins <https://github.com/BitBagCommerce>`_
* `FriendsOfSylius plugins <https://github.com/FriendsOfSylius/SyliusGoose>`_