settings.yml

show_category_name:
  type: bool
  default: true
  description: 'Show the category name in the header'
  
show_category_description: 
  type: bool
  default: true
  description: 'Show the category description text<br>(The first paragraph of the "About this category" topic)'

description_text_size:
  type: enum
  default: larger  
  choices:
  - smaller
  - normal
  - larger    
  - largest      
  description: 'Size of text within the category description'  

text_align:
  type: enum
  default: left  
  choices:
  - left
  - center
  - right     
  description: 'Alignment of the text within the category header'  
  
show_subcategory_header: 
  type: bool
  default: true
  description: 'Show header for subcategories'  
  
show_parent_category_name: 
  type: bool
  default: true
  description: 'Prefix the parent category name on the subcategory headers'   
  
show_lock_icon:
  type: bool
  default: true
  description: 'Show the lock icon on categories protected by permissions' 
  
show_category_logo:
  type: bool
  default: true
  description: 'Show the category logo image within the header'
  
show_parent_category_logo:
  type: bool
  default: true
  description: 'Show the parent category logo when a subcategory logo is not set'    
  
show_site_logo:
  type: bool
  default: true
  description: 'Show the small site logo if a category logo is not set'  
  
position_logo:
  type: enum
  default: left  
  choices:
  - left
  - right
  - top
  description: 'Position of the logo within the header. Left and right display the logo inline with the text<br>Top displays the logo above aligned with the text'  
  
size_logo:
  type: enum
  default: standard  
  choices:
  - standard
  - small  
  - original
  description: 'Position of the logo within the header.<br>Small is 40px high similar to a sub
  category box logo<br>Standard is 150px high<br>Original is the size of the image uploaded'    
  
header_style:
  type: enum
  default: box  
  choices:
  - box
  - banner
  - none
  description: 'Set the header style to either:<br>Box, style as a box with the category background color as the left border<br>Banner, set the header background to the category background color and text to the forground color<br>None, no styling<'
   

header_background_image:
  type: enum
  default: contain  
  choices:
  - contain  
  - cover
  - resize
  - outside
  description: 'Applies if you have uploaded a category background image<br>Contain, cover and resize display the background within the header<br>Outside is the Discourse default displaying it outside the header.'
  
show_mobile: 
  type: bool
  default: true
  description: 'Show category header on mobile devices'
  
force_mobile_alignment:  
  type: bool
  default: true
  description: 'Force mobile alignment of logo-text to the top-centre of the header'
  
hide_if_no_category_description: 
  type: bool
  default: true
  description: 'Hide header if category description is not set'    

hide_category_exceptions:
  type: list
  default: '' 
  description: 'Headers will not show for these categories'