[META] Track 5: Create "Contact form" recipe

Created on 14 June 2024, about 1 year ago
Updated 20 September 2024, 10 months ago

Summary

Create a recipe for a contact form as one of the official recommended recipes. (See #3454528: [META] Track 4: Recommend official recipes in the installation process β†’ )

Work to be done for official launch (in scope)

  • Do user research with target persona to define the key requirements / features for the recipe
  • Do competitive research and describe what feature parity looks like and how we might build a differentiated / better solution
  • Map the key requirements to recommend modules to use to build the recipe
  • Build the recipe with default configuration, default content, sample content, etc
  • Acceptance testing: test that the recipe meets the requirements and expectations of the target persona
  • Set up quality/integration tests to make sure the recipes keeps working
  • Define and drive required user experience improvements to contributed modules
  • Basic documentation for the Recipe
  • Recipe logo, summary, screenshots for use in Project Browser

Out of scope for official launch

TBC

Target milestone

DrupalCon Barcelona

Skills required

  • UX researcher
  • Designer
  • Writer
  • Developer

Blockers / dependencies

  • Drupal Starshot design system / design guidelines
  • Drupal Starshot Leadership team to sign off on recipe, including module selection, design choice, documentation, etc

Track lead

J. Hogue ( artinruins β†’ ) and the team from from Oomph Inc. β†’

πŸ“Œ Task
Status

Active

Component

Track: Contact form

Created by

πŸ‡¦πŸ‡ΊAustralia pameeela

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

  • Issue created by @pameeela
  • πŸ‡ΊπŸ‡ΈUnited States thejimbirch Cape Cod, Massachusetts
  • πŸ‡¦πŸ‡ΊAustralia pameeela

    This track is in need of a lead. See Dries' blog post for more info, read about the track lead position β†’ , or just apply now!

  • πŸ‡ΊπŸ‡ΈUnited States rachelh_design

    We're attempting to organize a team to work on this at Oomph. For me, I can help with gathering requirements and any design needs. Once we find the right person to lead, we'll send in the application!

  • πŸ‡¦πŸ‡ΊAustralia pameeela

    Great news, thanks @rachelh_design!

  • πŸ‡¦πŸ‡ΊAustralia pameeela
  • πŸ‡¦πŸ‡ΊAustralia pameeela
  • πŸ‡ΊπŸ‡ΈUnited States pfrilling Minster, OH
  • Pipeline finished with Failed
    10 months ago
    Total: 50s
    #288304
  • Pipeline finished with Failed
    10 months ago
    Total: 86s
    #288305
  • Merge request !98Resolve #3454545 "Contact form recipe" β†’ (Merged) created by pfrilling
  • Pipeline finished with Failed
    10 months ago
    Total: 53s
    #288308
  • Pipeline finished with Success
    10 months ago
    #288310
  • Pipeline finished with Success
    10 months ago
    Total: 369s
    #288311
  • Pipeline finished with Success
    10 months ago
    Total: 400s
    #288325
  • Pipeline finished with Success
    10 months ago
    Total: 425s
    #288326
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    There are a few things here which need to be changed.

  • Pipeline finished with Canceled
    10 months ago
    Total: 117s
    #292301
  • Pipeline finished with Canceled
    10 months ago
    Total: 117s
    #292302
  • Pipeline finished with Success
    10 months ago
    Total: 675s
    #292305
  • Pipeline finished with Success
    10 months ago
    Total: 688s
    #292306
  • πŸ‡ΊπŸ‡ΈUnited States pfrilling Minster, OH

    I fixed the obvious things and left comments for a few others. Changing this to needs review for visibility, but I'm sure more work will follow.

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Thank you for the very clear and sensible explanations! I think I can see a few ways forward; commented in the MR. Curious what you think.

  • Pipeline finished with Success
    10 months ago
    Total: 643s
    #299161
  • Pipeline finished with Success
    10 months ago
    Total: 1228s
    #299162
  • πŸ‡ΊπŸ‡ΈUnited States pfrilling Minster, OH

    I think this is ready to review again.

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    This issue has an MR needing review, so I guess it's...not a meta. Removing that designation.

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    That looks pretty good to me overall, just a few points of clarification/feedback/follow-ups.

  • Pipeline finished with Success
    10 months ago
    Total: 1603s
    #300002
  • Pipeline finished with Success
    10 months ago
    Total: 1641s
    #300001
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Everything looks great here - I just have a suggestion for `drupal_cms_anti_spam` so that we can be certain the `authenticated` user role exists, without merely hoping that it was installed by the User module (even though it's a required role -- we're just being paranoid here).

    Once that suggestion is implemented (or kicked back if it doesn't work), I'm okay committing this.

  • πŸ‡¦πŸ‡ΊAustralia pameeela

    We still want a meta, so I created a new one and updated references.

  • πŸ‡©πŸ‡ͺGermany jurgenhaas Gottmadingen

    With regard to the anti spam integration of the contact form, please note there is a proposal at πŸ“Œ Add the friendlycaptcha module Active to use friendlycaptcha for that. The contact form recipe requires the antispam recipe, so if the antispam changes strategy, this will change for the contact form as well.

    Just wanted to leave this heads-up here just so that this recipe doesn't necessarily have to put extra effort into anti-spam, unless you have additional requirements?

  • Pipeline finished with Failed
    9 months ago
    Total: 635s
    #312845
  • Pipeline finished with Failed
    9 months ago
    Total: 2002s
    #312846
  • Pipeline finished with Failed
    9 months ago
    Total: 460s
    #312902
  • Pipeline finished with Failed
    9 months ago
    Total: 483s
    #312901
  • πŸ‡ΊπŸ‡ΈUnited States pfrilling Minster, OH

    I addressed all the feedback in the MR.
    - I decided to list out all of the webform configuration instead of archiving the one form that shipped with Webform.
    - I reverted any changes I made to the anti spam recipe. I'll create a followup issue to address changes in #3477309
    - I did add a cypress e2e test, which passes locally, but not in CI. I don't think the E2E testing is configured quite right in the CI. It seems that the site is not getting installed in that CI environment.

  • Pipeline finished with Failed
    9 months ago
    Total: 722s
    #312916
  • Pipeline finished with Failed
    9 months ago
    Total: 755s
    #312917
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    This is shaping up; I love the test coverage! However, there are some flaws here that arise from a few minor misunderstandings of how to write recipes. I'm also very ambivalent about explicitly importing all of Webform's config entities, even the ones we don't need.

  • Pipeline finished with Failed
    9 months ago
    Total: 630s
    #312950
  • Pipeline finished with Failed
    9 months ago
    Total: 655s
    #312949
  • Pipeline finished with Failed
    9 months ago
    Total: 753s
    #312963
  • Pipeline finished with Failed
    9 months ago
    Total: 759s
    #312962
  • πŸ‡ΊπŸ‡ΈUnited States pfrilling Minster, OH

    I believe I addressed everything. This is ready for another review.

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Tests are failing, and we'll need to fix that before merging -- but I'm also busily building a basic framework for Cypress testing over in πŸ“Œ Add Cypress test to the base SEO recipe Active , so let's postpone this on that.

  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Alright - πŸ“Œ Add Cypress test to the base SEO recipe Active is in, so I think we can start hauling this to the finish line! Let's get the tests passing, and model the E2E tests on drupal_cms_seo_basic/tests/e2e/spec.cy.js.

  • Pipeline finished with Failed
    9 months ago
    Total: 974s
    #313042
  • Pipeline finished with Failed
    9 months ago
    Total: 852s
    #313064
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    I think this is good to go. The recipe looks good, is lean, and has strong test coverage (thanks @pfrilling)! We don't need to hold this up any longer. With regard to @jurgenhaas's point in #20, the tests will certainly help us adjust properly if and when we switch to Friendly CAPTCHA.

    I'm shipping it!

  • Pipeline finished with Failed
    9 months ago
    Total: 506s
    #313072
  • Pipeline finished with Failed
    9 months ago
    Total: 798s
    #313088
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Hmmm...something odd is going on with one test, not sure why - self-assigning to figure it out.

  • Pipeline finished with Failed
    9 months ago
    Total: 925s
    #313180
  • Pipeline finished with Failed
    9 months ago
    Total: 988s
    #313194
  • Pipeline finished with Failed
    9 months ago
    Total: 190s
    #313210
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Boy, getting this to work properly took some doing, but it also revealed a major flaw in the way I built some of the Cypress infrastructure in πŸ“Œ Add Cypress test to the base SEO recipe Active . What can I say...this whole thing is a learning experience. Anyway - that flaw, at least, is fixed and means that specs are properly isolated from each other.

  • Pipeline finished with Skipped
    9 months ago
    #313216
  • πŸ‡ΊπŸ‡ΈUnited States phenaproxima Massachusetts

    Finally! The ship sails. Great work here!

  • Automatically closed - issue fixed for 2 weeks with no activity.

Production build 0.71.5 2024