First steps with django CMS

Basic django CMS introduction given at PyCon UK 2014

Transcript

1. PYCON UK 2014 FIRST STEPS WITH DJANGO CMS by Iacopo Spalletti @yakkys
2. WHO AM I? Founder and Lead developer @NephilaIt django CMS core developer django CMS installer author
3. DJANGO CMS FIRST LOOK BRIEF OVERVIEW OF DJANGO CMS FEATURES FEEL FREE TO COME TO THE BOOTH OR AT THE SPRINTS FOR MORE
4. WHAT'S DJANGO CMS? 'JUST' A CMS FOR DJANGO (APPARENTLY) With a twist!
5. DJANGO CMS HOW IS DIFFERENT? IT'S LIMITED (BY DESIGN) YOU CANNOT "EXTEND" A PAGE
6. DJANGO CMS WHY IS THAT? WHY NOT? WE HAVE DJANGO MODELS! GOOD DJANGO CITIZEN
7. DJANGO CMS CONTRIBUTING FEATURES django CMS provides features that your applications can use
8. BASIC CONCEPTS PAGE PLACEHOLDER PLUGIN APPHOOK FRONTEND EDITOR
9. LIVES IN A LIVE AND DRAFT VERSION DEFINED BY THE TEMPLATE APPLIED TO IT PAGE THE BUILDING BLOCK OF THE CMS
10. PLACEHOLDER ACTIVE AREAS WITHIN YOUR PAGES PLUGIN CONTAINERS DEFINED IN THE TEMPLATES JUST A TEMPLATETAG
11. PLACEHOLDER HOW TO DEFINE A PLACEHOLDER? {% placeholder "first_placeholder" %}
12. PLACEHOLDER THERE IS MORE class MyModel(models.Model): name = models.CharField(max_length=200) abstract = models.TextField() content = PlaceholderField() Composition, not inheritance
13. PLUGIN Placeholder = Container Plugin = Content
14. PLUGIN WHAT'S A PLUGIN? A content A bridge towards other Django applications
15. PLUGIN WRITING PLUGIN IS EASY class MyPlugin(CMSPluginBase): name = _('My plugin') render_template = 'myapp/myplugin.html'
16. PLUGIN 1. PLUGIN CLASS class MyPlugin(CMSPluginBase): name = _('My plugin') model = MyPluginModel render_template = 'myapp/myplugin.html' def render(self, context, instance, placeholder): newslist = News.objects.all().order_by('-date') context.update({ 'instance': instance, 'news_list': newslist[:instance.posts] }) return context Plugin = ModelAdmin + template + get_context_data
17. PLUGIN 2. THE PLUGIN MODEL It's the plugin configuration class MyPluginModel(CMSPlugin): title = models.CharField(max_length=200) posts = models.PositiveIntegerField()
18. PLUGIN 3. THE TEMPLATE Template is a standard Django template fragment to which the plugin generated context is provided <div class="news_list"> <h2>{{ instance.title }}</h2> {% for news in news_list %} <a href="{{ news.get_absolute_url }}"> {{ news.title }}</a><br> {% endfor %} </div>
19. APPHOOK Is a bridge between the CMS and other Django applications In rough terms, it appends the application URLConf to the page tree
20. It wraps the URLCon in a class APPHOOK SOME CODE class MyApp(CMSApp): name = _("My App") urls = ["apps.my_app.urls"] menus = [MyMenu] apphook_pool.register(MyApp)
21. APPHOOK THAT'S ALL :)
22. FRONTEND EDITOR WARNING! IT'S ADDICTIVE!
23. FRONTEND EDITOR WHAT'S IT? NEW IN DJANGO CMS 3 ADMIN OUTSIDE THE ADMIN
24. FRONTEND EDITOR FOLLOW THE WHITE PONY
25. FRONTEND EDITOR TOOLBAR COMPLETE SIMPLE DYNAMIC CUSTOMIZABLE
26. FRONTEND EDITOR ANCHE NEI VOSTRI MODEL EVERY MODEL CAN BE FRONTEND-ENABLED {% render_model instance "abstract" %} {% render_model_block instance %} <h3>{{ instance.title }}</h3> <div class="date">{{ instance.date }}</div> {% endrender_model_block %}
27. SHAMELESS PLUG!
28. GRAZIE! SEE YOU TOMORROW! DJANGO CMS SPRINT And tips and support to use django CMS Iacopo Spalletti i.spalletti@nephila.co.uk @yakkys