TYPO3 Neos is the next-generation content management system of the TYPO3 community. In this guide I will explain the simple installation process to help people to get started with this stunning CMS.
Download the presentation under: http://www.exponeos.com/TYPO3-Neos-Alpha1-Installation-Guide-typovision.pdf
Have fun with TYPO3 Neos!!
2. TYPO3 NEOS?
The Next Generation CMS
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 2
3. WHAT IS TYPO3 NEOS?
• TYPO3 Neos is the next-generation content management system
of the TYPO3 community.
• It is based on the TYPO3 Flow Application Framework (formerly known as
FLOW3)
• The code name was TYPO3 Phoenix and it was meant to be the
successor of the famous TYPO3 CMS.
• From 05th of october 2012 it is called TYPO3 Neos
• Neos = νέος = is greek and means: new, fresh, young, ...
(http://en.wiktionary.org/wiki/%CE%BD%CE%AD%CE%BF%CF%82)
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 3
4. WHAT MAKES NEOS SPECIAL?
• What makes Neos so special?
• Neos is build with the developers needs in mind
• Neos foundation is the rock solid framework TYPO3 Flow
• Neos is build for extensibility - there are plugins and TypoScript (yeah!)
• Neos has In-Page editing via Aloha (or Hallo) Editor in place
• Neos uses not just a relational database but a fully featured content
repository - called TYPO3CR
• Neos is much more than just a CMS - there is a deployment tool called
TYPO3 Surf for instance which can easily talk to your Jenkins server
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 4
5. SYSTEM REQUIREMENTS
to run TYPO3 Neos
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 5
6. SYSTEM REQUIREMENTS
• What do you need to run TYPO3 Neos?
• A web server
(recommended is Apache with the mod_rewrite module enabled)
• PHP 5.3.2 - 5.4.x
• Make sure these PHP-Functions are not disabled: system(), shell_exec(),
escapeshellcmd() and escapeshellarg()
• php.ini: memory_limit should 256M or more
• php.ini: xdebug.max_nesting_level = 500 (if you use xdebug)
• MySQL 5.1.50 - 5.x.x
(for this guide - later Doctrine DBAL DBs are possible)
• Command line access
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 6
7. INSTALLATION
Get ready for Neos!
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 7
8. INSTALL STEP 1
• Installing Neos: Step 1 - Files
• Download Sources from this URL:
http://neos.typo3.org/TYPO3-Neos-1.0-alpha1.zip
• Unzip the sources to your htdocs directory
• This directory depends on your system - could be
/opt/local/apache2/htdocs
/var/www
/Applications/XAMPP/xamppfiles/htdocs
C:xampphtdocs
...or similar...
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 8
9. INSTALL STEP 2
• Installing Neos: Step 2 - Virtual Host
• Add a virtual host entry (important is pointing to Web-Subdir in
DocumentRoot-Path):
NameVirtualHost *:80 # if needed
<VirtualHost *:80>
DocumentRoot "/your/htdocs/TYPO3-Neos-1.0-alpha1/Web/"
# skip the following line for development
Setenv FLOW_CONTEXT Production
ServerName neos.demo
</VirtualHost>
• Add an entry to your /etc/hosts file
127.0.0.1 neos.demo
• Restart webserver
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 9
10. INSTALL STEP 2
• Installing Neos: Step 2 - Virtual Host
• Or use your tool settings
if you use a tool like MAMP
or MAMP PRO:
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 10
11. INSTALL STEP 3
• Installing Neos: Step 3 - Permission
• Correct user permissions on a Mac/Linux-System:
sudo ./flow flow:core:setfilepermissions shelluser
wwwuser wwwgroup
• As shelluser use the user with you logged into your system
(patricklobacher on mine system e.g.) or create a new user for this
• As wwwuser use the user the webserver runs with - this could be one
of the following: _www, www, www-data, httpd
• As wwwgroup use the group the webserver runs with - this could be
one of the following: _www, www, www-data, httpd
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 11
13. SETUP STEP 1
• Go to the Neos setup page with the browser: http://neos.demo/setup/
• The (random)
password
can be found at
/htocspath/Data/
SetupPassword.txt
• Open the file and
write down the pass
• The file will be
deleted after
installation
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 13
14. SETUP STEP 1
• If you have already done the setup or something else went wrong, you have to
reset the password. For this, delete the file
/hotdocspath/Data/Persistent/FileBasedSimpleKeyService/SetupKey
and restart the setup.
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 14
15. SETUP STEP 2
• If credentials are correct, you will find a „Connection established“ at the
bottom in green color (no need to sub,it - it‘s an AJAX check)
• After this, choose
[New Database]
and enter a
database name
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 15
16. SETUP STEP 2
• After this enter the credentials for you database connection - as server try
localhost or 127.0.0.1 if it is on your machine.
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 16
17. SETUP STEP 3
• Enter your personal info in the next form
• For the username
you can use letters
A-Za-z and
Numbers 0-9
- no other chars.
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 17
18. SETUP STEP 4
• Now you can import a existing Demo-Site (suggested) or create a new site.
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 18
20. TROUBLESHOOTING
What if anything went wrong?
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 20
21. TROUBLESHOOTING 1
• If you get the „Could not connect to database“ message although your
credentials are correct -
try to use „localhost“
instead of „127.0.0.1“
in the DB Host* Field
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 21
22. FRONTEND
Play with the demo site
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 22
24. NEOS FRONTEND
• Play around with the demo site and enjoy it :-)
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 24
26. NEOS BACKEND
• Access Backend: http://neos.demo/neos
• Credentials
taken from
form shown
on slide 17
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 26
27. NEOS BACKEND
• You are starting in the „Content Tab“
• Be sure to check out
the „Management“ &
„Adminstration Tab“
as well.
• Create additional
user with the
„Administration Tab“
• Check the Fullscreen-,
Pages- and Wireframe-
Button.
• Note the Inspect-Button
• Have much fun with Neos :-)
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 27
29. ROADMAP
• What is planned for the next releases of TYPO3 Neos?
• Consistent Visual Design
• Multi-language support in TYPO3CR and User Interface
• JavaScript and Server-Side Code Cleanup
• Expose: An Extensible Admin Interface
• Content Synchronization and Syndication
• See full description at: http://neos.typo3.org/roadmap.html
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 29
30. WANTED
Time to spend?
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 30
31. WANTED
• The TYPO3 Neos Team needs YOU!!!
• TYPO3 Neos cannot be built without participation of many dedicated
community members – we need your help to implement your favourite
feature.
• Just get in touch with us, so we can bring you up to speed.
• We're always looking for new contributions. Can you help in the following
areas?
• Code Offer contribution
• Testing Want to offer your contribution?
• Usability Please get in touch with us on
• Documentation mailing lists or IRC (irc.freenode.net,
channel #typo3-flow or #typo3-
• Feature ideas
neos) so we can find you someone
• Anything else useful to TYPO3 Neos
to mentor your contribution.
• Please offer your contribution!
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 31
32. SOURCES
Get your information
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 32
35. ABOUT PATRICK LOBACHER
• Patrick Lobacher (born Schuster) - CEO
• 42 years, happily married, residing in Munich
• Author of 7 books and 35 articles on the subject of TYPO3
und web development
• Certified TYPO3 Integrator since 2009
• Until 2012 member of the teams Extbase (Leader),
Certification and EAB (Expert Advisory Board)
• Co-Organizer of the TYPO3camp Munich and
TYPO3 Developer Days (T3DD12 and T3DD13)
• Speaker at natiional and internation conferences
• Lecturer for leading training institutes and MVHS
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 35
36. ABOUT TYPOVISION GMBH
• Full service digital communications agency from Munich
• Platinum member of the TYPO3 Association
• Approx. 30 employees (+ 10 from fixed freelancer pool)
• CEO: Sebastian Böttger & Patrick Lobacher
• Specializing in TYPO3 since 10 year (Extbase/Fluid since 2009)
• Presentation (german): www.typovision.de/dieagentur
• More than 500 TYPO3 projects of any size - for customer like:
(c) 2012 - typovision GmbH | TYPO3 Neos Alpha Installation Guide | Patrick Lobacher | www.typovision.de | 06.10.2012 36