Skip to content

For NameSpace, action templates directory must be view/name-space #77

@pbcGIS

Description

@pbcGIS

Referring to docs/modules/index.md

I tried a lot of things before I figured out that for a camel-case "ModuleName", the namespace must be ModuleName and the action templates must be in a folder named "view/module-name" .. The documentation on the page referenced above is confusing, since the example directory structure is not coherent with the example files provided on the same page in terms of the module name or namespace. It would also help if the text explained that the action templates folder must be the CamelCase NameSpace expressed as all lower case with the words divided by a hyphen.

Unspoken naming requirements and folder structure is an aspect of occult convention/requirements for file names and folder structure that makes Laminas and Omeka very difficult to learn! Or is there a basic PHP document somewhere that describes these conventions?

I've created a working module named HelloWorld that might be useful to use in example snippents to make them more coherent and to give noobies a leg up. https://github.com/C-Dash/Omeka-S-Module-HelloWorld/

I do appreciate the overall quality of Omeka-S and the valuable work that you all are sharing. I hope that communicating my frustration with learning to code php is not taken as ingratitude. If it would be helpful for me to redraft this page, I would be happy to submit a formal pull request.

Thank you.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions