.. _fcommon:

##################################################################
``common`` — Get HTML from a view file in the common/ directory.
##################################################################

:doc:`Layout-related functions </Reference/packages/Function/View/Layout/index>`

*******
Summary
*******

.. include:: /Reference/libraries/globals/summary/common.rst

.. php:function:: common($file, $vars = array(), $dir = 'common')

    Get HTML from a view file in the common/ directory.
    
    Optionally, parameters can be passed to the view, and the view can be
    loaded from a different directory.
    
    :type $file: string
    :param $file: Filename
    :type $vars: array
    :param $vars: A keyed array of variables to be extracted into the script
    :type $dir: string
    :param $dir: Defaults to 'common'
    :returns: string

*****
Usage
*****

.. include:: /Reference/libraries/globals/usage/common.rst

********
Examples
********

.. include:: /Reference/libraries/globals/examples/common.rst

********
See Also
********

.. include:: /Reference/libraries/globals/see_also/common.rst