Docker¶

Installation¶

• Server: webwork20
• Path: /var/docker/[user]/
• Checkout git repo:
  

  git clone https://systemvcs.math.uzh.ch/it/typo3-docker.git
  

• rename the typo3-docker folder! [user]-[instance] ex. bbaer-dev
• execute bootstrap.py
  

  cd [user]-[instance]
  python3 bootstrap.py
  

• You see a list with your links and Ports.
• After setup, navigate to https://webwork20:xxxx/typo3/install.php
  
• Type in your typo3 backend user and password, etc.; click continue
  
• Choose "take me straight to the backend"
• Login
• Go to extension and add fluid styled content:
  !typo3_3.png
• Install latest qfq (https://qfq.io/download/?dir=releases) and uzh_cd (https://www.math.uzh.ch/repo/?dir=uzhcd/v9)
• Create first page:
  
  
  
• Under access, set page visible to true
• Add template to home (via plus):
  
  
  

• Add page content > QFQ to home

10.sql = SELECT "Hello world from QFQ, ", NOW()

• Try view page on home for a first test:
  

• As instructed, create a new page "Form" with pagecontent [QFQ] Form under Home and load the formEditor:
  

  file=_formEditor
  

• Reload the page
  

• Done with typo3!

.h2 Configuring phpstorm

• You need the url of the page AND the xdebug port from the installation. If you do not remember them, see config.json in your docker folder.
• Open PHP Storm, go to File > Settings > PHP > Debug
  
• List all of the xdebug ports of your docker containers, comma separated. REMOVE 9000, else phpstorm will still stop webwork16.
• Add Server:
  
  • Please give a detailed name, eg. webwork20 dev, there will be multiple deployments on the same server!
  • Use the port for the website, not the xdebug port!
  • You can already map the path of extension > /var/www/html/typo3conf/ext/qfq/
  • You may not see the typo3 sources:
    
  • If you see it, map typo3_src_10.4.34 to /var/www/typo3_src (see screenshot)
  • If not, add additional sources to your phpstorm project, then do above:
    
    • Got to File > Settings > Directories and Add new Root Directory
    • Add /scratch/software/typo3
    • Mark typo3_src_10.4.34 as Source Folder (also extension in the qfq folder, if you haven't)
• Finally add a new xdebug setting:
  
  
  • Here you can select the server you added before
  • Remove webwork16 if you didn't remove port 9000, to not stop webwork16 by accident.
• Deployment path:
  • Run > Deployment > Configuration