search

cakephp / api_generator

[Unmaintained] Official CakePHP API Generator Git Repository
113 stars 31 forks source link

Plugin layout overrides app layout : difficult to integrate properly the plugin in an existant application #5

Closed ghost closed 9 years ago

ghost commented 11 years ago

Created by Predominant, 12th Dec 2009. (originally Lighthouse ticket #2):

(Reported by: scharrier)

As there's a default.ctp file in the plugin layout's directory, it's not actually possible to integrate properly (= with same design) the api_generator as a module in an existant application, without modifying his layout. I think it would be better to include the .js, .css and menus directly in the views (not inline), in order to delete default.ctp. Integration with existing dev environnement would be better ! For an example, we actually have a dev environment, with functionnals tests, user documentation wiki, unit tests reports, and API doc, in the same app (so with the same menu in every pages, same design, etc ...). We just want all our plugins to use the same design and navigation schema ! Thanks a lot for your answer :-) Sébastien Charrier

ghost commented 11 years ago

12th Dec 2009, Predominant said:

(Comment by: mark_story)

You can just delete the layout as well, it will default to using the next default.ctp it order. You just loose the search element and navigation in doing so. Since both of these elements are 'layout' level elements, I made a layout so I could include them. I don't really know how it would work in a layout-less mode. Perhaps you can explain?

FabianOudhaarlem commented 9 years ago

I fixed it by renaming the layout file to api_generator.ctp and inside the api_generator_app_controller i added 

public $layout = 'api_generator';
markstory commented 9 years ago

@FabianOudhaarlem This project is basically abandoned at this point. You might want to consider using ApiGen or PHPDocumentor instead. They are more well maintained and should have fewer issues long term.