Tweet
Tweet

Slide 1

Slide 1 text

Parse Order Pro By Lodewijk Schutte ~ Low, October 2011

Slide 2

Slide 2 text

Hi! I'm Low!

Slide 3

Slide 3 text

gotolow.com

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

ExpressionEngine’s Parse Order In what order does EE parse its variables and tags? Read URI to determine template Get template from DB, check permissions & authentication Get template from file Return static template 1. Parse snippets / global variables, segment variables and embed variables * Parse date string constants Parse {template_edit_date} and {current_time} If present, get cached template, then go to #7 2. Parse PHP on Input 3. Parse simple conditionals: segment, embed, global variables 4. Assign and parse preload_replace variables 5. Parse module and plugin tags 6. Parse PHP on Output Write cache file 7. Parse advanced conditionals 8. Process embedded templates Redirect 9. Parse User Defined global variables and others: {hits} {ip_address} {gzip_mode} {app_version} {group_title} {member_group} gotolow.com/parse-order

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

Parse Order Parse Order

Slide 8

Slide 8 text

No content

Slide 9

Slide 9 text

How does parsing work? •Document (template) •Markers (variables and tags) •Values (data) •Find & Replace (parsing)

Slide 10

Slide 10 text

Parse Order Parse Order

Slide 11

Slide 11 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  3 {a} {b} {a} {c} {c}

Slide 12

Slide 12 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  3 1 {b} 1 {c} {c}

Slide 13

Slide 13 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  3 1 2 1 {c} {c}

Slide 14

Slide 14 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  3 1 2 1 3 3

Slide 15

Slide 15 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  3 1 2 1 3 3

Slide 16

Slide 16 text

No content

Slide 17

Slide 17 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} {a} {d} {b} {a} {c} {c} {e} {e}

Slide 18

Slide 18 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 {d} {b} 1 {c} {c} {e} {e}

Slide 19

Slide 19 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 {d} 2 1 {c} {c} {e} {e}

Slide 20

Slide 20 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 {d} 2 1 {d} {d} {e} {e}

Slide 21

Slide 21 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 3 2 1 3 3 {e} {e}

Slide 22

Slide 22 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 3 2 1 3 3 {a} {a}

Slide 23

Slide 23 text

Parse Order {a}  =>  1 {b}  =>  2 {c}  =>  {d} {d}  =>  3 {e}  =>  {a} 1 3 2 1 3 3 {a} {a}

Slide 24

Slide 24 text

No content

Slide 25

Slide 25 text

Parse Order in ExpressionEngine

Slide 26

Slide 26 text

Early vs. Late stuff {exp:tags} more  stuff Early Late

Slide 27

Slide 27 text

Input vs. Output stuff {exp:tags} more  stuff PHP  on  Input PHP  on  Output

Slide 28

Slide 28 text

Variables

Slide 29

Slide 29 text

Variable Scope

Slide 30

Slide 30 text

Variable Scope Global Variables: all templates

Slide 31

Slide 31 text

Variable Scope Regional Variables: single template

Slide 32

Slide 32 text

Variable Scope Local Variables: single template, inside tag

Slide 33

Slide 33 text

Global Variables •Parsed Early • Snippets • Config variables • Segment variables •Parsed Late • User Defined Global Variables • "Standard Global Variables" http://bit.ly/standard-global-vars

Slide 34

Slide 34 text

Regional Variables •Parsed Early • Embed variables • Preload replace variables * *) Parsed early-ish

Slide 35

Slide 35 text

Local Variables •Parsed during Tags •Can be more complex • Variable parameters • Variable pairs

Slide 36

Slide 36 text

All Variables snippets config  vars segment  vars embed  vars preload  replace  vars {exp:tags}  local  vars  {/exp:tags} user  defined  vars standard  vars

Slide 37

Slide 37 text

No content

Slide 38

Slide 38 text

Variables Example 1

Slide 39

Slide 39 text

{gv_header}

{sn_{segment_1}_title}  containing  {username}

{exp:channel:entries  channel="{segment_1}"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 40

Slide 40 text

Snippets {gv_header}

{sn_{segment_1}_title}  containing  {username}

{exp:channel:entries  channel="{segment_1}"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 41

Slide 41 text

{gv_header}

{sn_{segment_1}_title}  containing  {username}

{exp:channel:entries  channel="{segment_1}"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 42

Slide 42 text

Segment vars {gv_header}

{sn_{segment_1}_title}  containing  {username}

{exp:channel:entries  channel="{segment_1}"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 43

Slide 43 text

{gv_header}

{sn_news_title}  containing  {username}

{exp:channel:entries  channel="news"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 44

Slide 44 text

Tags & Local vars {gv_header}

{sn_news_title}  containing  {username}

{exp:channel:entries  channel="news"    search:cf_summary="{username}"}        

{title}

       {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 45

Slide 45 text

{gv_header}

{sn_news_title}  containing  {username}

{gv_footer}

Slide 46

Slide 46 text

User Defined Global vars {gv_header}

{sn_news_title}  containing  {username}

{gv_footer}

Slide 47

Slide 47 text

   {sn_{segment_1}_title}  -­‐  {site_name}

{sn_news_title}  containing  {username}

©  {current_date  format="%Y"}

Slide 48

Slide 48 text

Standard Global vars    {sn_{segment_1}_title}  -­‐  {site_name}

{sn_news_title}  containing  {username}

©  {current_date  format="%Y"}

Slide 49

Slide 49 text

   {sn_{segment_1}_title}  -­‐  EE  Outsider

{sn_news_title}  containing  kennymeyers

©  {current_date  format="%Y"}

Slide 50

Slide 50 text

Variables Example 2

Slide 51

Slide 51 text

{sn_header} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {sn_page} {gv_footer}

Slide 52

Slide 52 text

Snippets {sn_header} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {sn_page} {gv_footer}

Slide 53

Slide 53 text

   {gv_{segment_1}_title} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {exp:channel:entries  channel="{segment_1}"    limit="{pre_limit}"}        

{title}

       {pre_body} {/exp:channel:entries} {gv_footer}

Slide 54

Slide 54 text

Segment vars    {gv_{segment_1}_title} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {exp:channel:entries  channel="{segment_1}"    limit="{pre_limit}"}        

{title}

       {pre_body} {/exp:channel:entries} {gv_footer}

Slide 55

Slide 55 text

   {gv_news_title} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {exp:channel:entries  channel="news"    limit="{pre_limit}"}        

{title}

       {pre_body} {/exp:channel:entries} {gv_footer}

Slide 56

Slide 56 text

Preload Replace vars    {gv_news_title} {preload_replace:pre_limit="1"} {preload_replace:pre_body="{cf_summary}"} {exp:channel:entries  channel="news"    limit="{pre_limit}"}        

{title}

       {pre_body} {/exp:channel:entries} {gv_footer}

Slide 57

Slide 57 text

   {gv_news_title} {exp:channel:entries  channel="news"  limit="1"}    

{title}

   {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 58

Slide 58 text

Tags & Local vars    {gv_news_title} {exp:channel:entries  channel="news"  limit="1"}    

{title}

   {cf_summary} {/exp:channel:entries} {gv_footer}

Slide 59

Slide 59 text

   {gv_news_title}    

Missing:  Kenny  Meyers

   

Last  seen  at  Pier  39  San  Francisco,          hanging  out  with  some  friends.

{gv_footer}

Slide 60

Slide 60 text

User Defined Global vars    {gv_news_title}    

Missing:  Kenny  Meyers

   

Last  seen  at  Pier  39  San  Francisco,          hanging  out  with  some  friends.

{gv_footer}

Slide 61

Slide 61 text

   The  News    

Missing:  Kenny  Meyers

   

Last  seen  at  Pier  39  San  Francisco,          hanging  out  with  some  friends.

©  {site_name}

Slide 62

Slide 62 text

Standard Global vars    The  News    

Missing:  Kenny  Meyers

   

Last  seen  at  Pier  39  San  Francisco,          hanging  out  with  some  friends.

©  {site_name}

Slide 63

Slide 63 text

   The  News    

Missing:  Kenny  Meyers

   

Last  seen  at  Pier  39  San  Francisco,          hanging  out  with  some  friends.

©  EE  Outsider

Slide 64

Slide 64 text

No content

Slide 65

Slide 65 text

Conditionals

Slide 66

Slide 66 text

Conditional Types •Simple •Advanced •Special

Slide 67

Slide 67 text

Simple Conditionals •Only work with early parsed variables * •Only work with one operand •Only work without if:else statement •If so, are parsed before tags *) Except Preload Replace variables

Slide 68

Slide 68 text

Advanced Conditionals •All other conditionals * •Converted to PHP, then evaluated •Are parsed after tags *) Except special conditionals

Slide 69

Slide 69 text

PUT CODE IN CONDITIONALS STILL PARSES ALL THE TAGS

Slide 70

Slide 70 text

Special Conditionals •Parsed during and by tags •For example: • {if no_results} {/if} • {if next_page} {/if} • etc. •But most conditionals in tags are actually advanced conditionals

Slide 71

Slide 71 text

simple  conditionals {exp:tags}  special  conditionals  {/exp:tags} advanced  conditionals All Conditionals

Slide 72

Slide 72 text

Conditionals Example 1

Slide 73

Slide 73 text

{if  segment_3  ==  'by-­‐category'}    {exp:channel:categories  channel="bars"}            {category_name}    {/exp:channel:categories} {if:else}  {exp:channel:entries        channel="bars{if  logged_in}|foos{/if}"}            

{title}

           {if  no_results}Nothing  found!{/if}    {/exp:channel:entries} {/if}

Slide 74

Slide 74 text

Simple conditionals {if  segment_3  ==  'by-­‐category'}    {exp:channel:categories  channel="bars"}            {category_name}    {/exp:channel:categories} {if:else}  {exp:channel:entries        channel="bars{if  logged_in}|foos{/if}"}            

{title}

           {if  no_results}Nothing  found!{/if}    {/exp:channel:entries} {/if}    

Slide 75

Slide 75 text

{if  segment_3  ==  'by-­‐category'}    {exp:channel:categories  channel="bars"}            {category_name}    {/exp:channel:categories} {if:else}  {exp:channel:entries        channel="bars{if  logged_in}|foos{/if}"}            

{title}

           {if  no_results}Nothing  found!{/if}    {/exp:channel:entries} {/if}

Slide 76

Slide 76 text

Tags & Special conditionals {if  segment_3  ==  'by-­‐category'}    {exp:channel:categories  channel="bars"}            {category_name}    {/exp:channel:categories} {if:else}  {exp:channel:entries        channel="bars{if  logged_in}|foos{/if}"}            

{title}

           {if  no_results}Nothing  found!{/if}    {/exp:channel:entries} {/if}

Slide 77

Slide 77 text

{if  segment_3  ==  'by-­‐category'}            Brooklyn            Manhattan            Queens {if:else}            Nothing  found! {/if}

Slide 78

Slide 78 text

Advanced conditionals {if  segment_3  ==  'by-­‐category'}            Brooklyn            Manhattan            Queens {if:else}            Nothing  found! {/if}

Slide 79

Slide 79 text

           Nothing  found!

Slide 80

Slide 80 text

Conditionals Example 2

Slide 81

Slide 81 text

{if  logged_in}    {exp:channel:entries  channel="bars"        {if  segment_3  !=  'all'}limit="2"{/if}}            

{title}

           {if  cf_bar_is_awesome  ==  'y'}                This  bar  is  awesome!            {/if}    {/exp:channel:entries} {/if} {if  sn_show_foos  ==  'y'}    {exp:channel:entries  channel="foos"}        

{title}

       {if  no_results}No  foos  found!{/if}    {/exp:channel:entries} {/if}

Slide 82

Slide 82 text

Simple conditionals {if  logged_in}    {exp:channel:entries  channel="bars"        {if  segment_3  !=  'all'}limit="2"{/if}}            

{title}

           {if  cf_bar_is_awesome  ==  'y'}                This  bar  is  awesome!            {/if}    {/exp:channel:entries} {/if} {if  sn_show_foos  ==  'y'}    {exp:channel:entries  channel="foos"}        

{title}

       {if  no_results}No  foos  found!{/if}    {/exp:channel:entries} {/if}

Slide 83

Slide 83 text

{if  logged_in}    {exp:channel:entries  channel="bars"        limit="2"}            

{title}

           {if  cf_bar_is_awesome  ==  'y'}                This  bar  is  awesome!            {/if}    {/exp:channel:entries} {/if}    {exp:channel:entries  channel="foos"}        

{title}

       {if  no_results}No  foos  found!{/if}    {/exp:channel:entries}

Slide 84

Slide 84 text

Tags & Special conditionals {if  logged_in}    {exp:channel:entries  channel="bars"        limit="2"}            

{title}

           {if  cf_bar_is_awesome  ==  'y'}                This  bar  is  awesome!            {/if}    {/exp:channel:entries} {/if}    {exp:channel:entries  channel="foos"}        

{title}

       {if  no_results}No  foos  found!{/if}    {/exp:channel:entries}

Slide 85

Slide 85 text

{if  logged_in}            

Bar  One

           {if  'n'  ==  'y'}                This  bar  is  awesome!            {/if}            

Bar  Two

           {if  'y'  ==  'y'}                This  bar  is  awesome!            {/if} {/if}        

Foo  One

       

Foo  Two

       

Foo  Three

Slide 86

Slide 86 text

Advanced conditionals {if  logged_in}            

Bar  One

           {if  'n'  ==  'y'}                This  bar  is  awesome!            {/if}            

Bar  Two

           {if  'y'  ==  'y'}                This  bar  is  awesome!            {/if} {/if}        

Foo  One

       

Foo  Two

       

Foo  Three

Slide 87

Slide 87 text

           

Bar  One

           

Bar  Two

               This  bar  is  awesome!        

Foo  One

       

Foo  Two

       

Foo  Three

Slide 88

Slide 88 text

Tags

Slide 89

Slide 89 text

Tag Types •Module or Plugin •Single or Pair

Slide 90

Slide 90 text

NOT SURE IF THAT'S A MODULE TAG OR A PLUGIN TAG

Slide 91

Slide 91 text

Module Tags •Parsed from the document root inwards •Repeated until no tags are left

Slide 92

Slide 92 text

Plugin Tags •Look inside for other tags first •If found, that tag is parsed first •Except if it's a plugin tag, then see previous •Cancel this behaviour with parse="inward"

Slide 93

Slide 93 text

Tags Example 1

Slide 94

Slide 94 text

{exp:channel:entries  channel="feeds"  limit="3"}    

{title}

   {exp:magpie  url="{feed_url}"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie} {/exp:channel:entries}

Slide 95

Slide 95 text

{exp:channel:entries  channel="feeds"  limit="3"}    

{title}

   {exp:magpie  url="{feed_url}"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie} {/exp:channel:entries}

Slide 96

Slide 96 text

   

First  title

   {exp:magpie  url="http://one.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}

Slide 97

Slide 97 text

   

First  title

   {exp:magpie  url="http://one.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}

Slide 98

Slide 98 text

   

First  title

   {exp:magpie  url="http://one.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}

Slide 99

Slide 99 text

   

First  title

   {exp:magpie  url="http://one.com/rss"}        {items}            

{magpie:title}

           {magpie:content}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"}        {items}            

{magpie:title}

           {magpie:content}        {/items}    {/exp:magpie}

Slide 100

Slide 100 text

   

First  title

   {exp:magpie  url="http://one.com/rss"}        {items}            

{magpie:title}

           {magpie:content}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"}        {items}            

{magpie:title}

           {magpie:content}        {/items}    {/exp:magpie}

Slide 101

Slide 101 text

   

First  title

           

Title  1.1

           

Lorem  ipsum  dolor  sit  amet

           

Title  1.2

           

The  lazy  dog  jumped  over  the  fox

   

Second  title

           

Title  2.1

                       

Title  2.2

           

Slide 102

Slide 102 text

Tags Example 2

Slide 103

Slide 103 text

{exp:channel:entries  channel="feeds"  limit="3"}    

{title}

   {exp:magpie  url="{feed_url}"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie} {/exp:channel:entries}

Slide 104

Slide 104 text

{exp:channel:entries  channel="feeds"  limit="3"}    

{title}

   {exp:magpie  url="{feed_url}"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie} {/exp:channel:entries}

Slide 105

Slide 105 text

   

First  title

   {exp:magpie  url="http://one.com/rss"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}

Slide 106

Slide 106 text

   

First  title

   {exp:magpie  url="http://one.com/rss"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}    

Second  title

   {exp:magpie  url="http://two.com/rss"  parse="inward"}        {items}            

{magpie:title}

           {exp:strip_html}{magpie:content}{/exp:strip_html}        {/items}    {/exp:magpie}

Slide 107

Slide 107 text

   

First  title

           

Title  1.1

           {exp:strip_html}

Lorem  ipsum              dolor  sit  amet

{/exp:strip_html}            

Title  1.2

           {exp:strip_html}

The  lazy  dog  jumped  over            the  fox

{/exp:strip_html}    

Second  title

           

Title  2.1

           {exp:strip_html}{/exp:strip_html}            

Title  2.2

           {exp:strip_html}{/exp:strip_html}

Slide 108

Slide 108 text

   

First  title

           

Title  1.1

           {exp:strip_html}

Lorem  ipsum              dolor  sit  amet

{/exp:strip_html}            

Title  1.2

           {exp:strip_html}

The  lazy  dog  jumped  over            the  fox

{/exp:strip_html}    

Second  title

           

Title  2.1

           {exp:strip_html}{/exp:strip_html}            

Title  2.2

           {exp:strip_html}{/exp:strip_html}

Slide 109

Slide 109 text

   

First  title

           

Title  1.1

           Lorem  ipsum  dolor  sit  amet            

Title  1.2

           The  lazy  dog  jumped  over  the  fox    

Second  title

           

Title  2.1

           ...            

Title  2.2

           ...

Slide 110

Slide 110 text

A Parse Order Pro •...can identify markers •...knows when they are parsed •...knows how to nest them •...and will always...

Slide 111

Slide 111 text

PARSE ALL THE THINGS! gotolow.com/parse-order

Slide 112

Slide 112 text

Questions?

Slide 113

Slide 113 text

Thank You! gotolow.com @low