Full.rst

.. ================================================== .. FOR YOUR INFORMATION .. -------------------------------------------------- .. -- coding: utf-8 -- with BOM.

Installation

Target group: Administrators

Installation process - step by step

In this installation guide, we will override some values and make our blog more individual. Some steps are already described in the :ref:`Quick Installation <quick_installation>`.

1. Import and install the extension

   • via the extension manager

2. Create the following pages

   • See :ref:`Quick Installation <quick_installation>`
   • Optional: add an RSS page (standard page) which will contain the RSS plugin
   • Optional: add a page (standard page) for subscribing to new blog posts

   

3. Include static template

   • See :ref:`Quick Installation <quick_installation>`

4. Add plugins to the pages

   • See :ref:`Quick Installation <quick_installation>`
   • Optional: add the RSS plugin to your RSS page
   • Optional: add the Blog Subscription Form plugin to the previously created page

5. Start to configure your Blog. This is an TypoScript example:

        plugin.tx_t3extblog {
                settings {
                        blogsystem {
                                posts {
                                        paginate {
                                                itemsPerPage = 99
                                                insertAbove = 1
                                                insertBelow = 1
                                                maximumNumberOfLinks = 50
                                        }
                                        metadata {
                                                enable = 1

                                                twitterCards {
                                                        enable = 0
                                                }
                                        }
                                }
                                comments {
                                        allowed = 1
                                        allowedUntil = +6 months
                                        approvedByDefault = 0

                                        subscribeForComments = 0
                                }
                        }
                }
        }
        module.tx_t3extblog < plugin.tx_t3extblog

See :ref:`Configuration <configuration>` for all possible settings.

Important

Assigning the TypoScript settings to backend context by using module.tx_t3extblog < plugin.tx_t3extblog is essential when overriding values. Don't forget it!

Important

Make sure to configure all mandatory settings, see the :ref:`minimal configuration <configuration-minimal>`!

Tip

It is recommended to use the constants in conjunction with custom TypoScript. Copy both configuration files (constants.typoscript and setup.typoscript located in EXT:t3extblog/Configuration/TypoScript) and include (using <INCLUDE_TYPOSCRIPT: source="FILE:EXT:my_extension/.../setup.typoscript"> them in your root template.

Next Steps

1. Setup the RSS page TypoScript: :ref:`RSS setup <administration-rss>`
2. Configure speaking URLs (optional): :ref:`Speaking URL configuration <configuration-speaking-url>`
3. Copy all templates, configure the paths in TS and start adjusting the HTML markup to your needs
4. Start blogging: :ref:`Users manual <users-manual>`.