.. include:: /Includes.rst.txt
.. index:: Blog Example
.. _The-Blog-Example:

A journey through the blog example
==================================

.. attention::

   About the code of the blog example:

   * :t3ext:`Blog Example in the TER <blog_example/>`
   * `Blog Example on Github <https://github.com/FriendsOfTYPO3/blog_example>`__

In this chapter you make a journey through a simple TYPO3 extension.
While traveling on this round trip, you will get to know more about extension
development with Extbase and Fluid and learn the most important stations and
coordinates of extension development with the help of an example extension. You
will first familiarize yourself with the geography and the typical
characteristics of an extension and determine which processes are running in the
background.

If you are looking for a manual specifically on creating an extension,
:ref:`creating-store-inventory-extension` will show you the right set of tools.
The chapter for this journey explains the fundamentals. It could also
have the title "Europe in five days." If you discover nice
places, you should revisit them later without the travel group.

You will find it beneficial to look at the source code while
reading this text, so you will have an easier time getting your bearings in your
own extension later.

.. note::

   If you use a debugger, it can be interesting to follow a full cycle
   in single step mode. For that, you have to set a breakpoint in the
   file :file:`Dispatcher.php`. You will find this class in the folder for Extbase
   :file:`typo3/sysext/extbase/Classes/`.

.. todo: Better set a breakpoint in the Bootstrap to not miss half the show.

At the end of this chapter, you will find a short comparison of the
traditional way to code an extension and an approach with Extbase and
Fluid.

.. toctree::
   :hidden:

   1-first-orientation
   2-the-stations-of-the-journey
   3-calling-the-extension
   4-and-action
   5-Get-Blog-from-the-Repository
   6-An-excursion-to-the-database
   7-Paths-on-the-Data-Map
   8-Back-in-the-controller
   9-Rendering-the-output-with-fluid
   10-Returning-the-result-to-TYPO3
   11-Alternative-route-creating-a-new-posting