How to modify UI?

[snowwolf007cn]

I need to customize my swagger ui, i.e, modify title, layout color, etc. How to do it?

[weierophinney]

If you want to alter the look-and-feel of the individual pages, you will want to create new templates for them, and then instruct the view manager to use your own.

So, let's assume you've created your API as the "Api" module:

• create a view/ directory in your module.
• copy vendor/zfcampus/zfcampus/zf-apigility-documentation-swagger/view/zf-apigility-documentation-swagger/*.phtml to your new view/ directory.

• add the following to your Api module's config/module.config.php:

  'view_manager' => array(
    'template_map' => array(
        'zf-apigility-documentation-swagger/show' => __DIR__ . '/../view/show.phtml',
        'zf-apigility-documentation-swagger/list' => __DIR__ . '/../view/list.phtml',
    ),
  ),

• modify those templates

The "list" view uses the zf-apigility layout. To modify that, change the module/Application/view/layout/layout.phtml file.

In terms of modifying colors in the swagger UI, you'll likely want to introduce your own CSS. Write your own CSS, and in the "show" template, add your CSS file.