Support adding the text content within the <footnotes> element

Can you provide steps/screenshot('s) of how you want to use it? Is it source editing or actual unformatted text? Can you provide example markup of what you expect to work that is being escaped.

Here is a typical footnote:

"Budget: 1,694,339.00 (USD)" Malaria Consortium, "Support Scale up of Seasonal Malaria Chemoprevention (SMC)," 2015. We also searched the Gates Foundation's grant database to see whether it made any additional grants to Malaria Consortium for SMC work, but only saw this grant (grant page available at Gates Foundation, "Malaria Consortium").

"Malaria Consortium is implementing and assessing the feasibility of a community-based seasonal malaria chemoprevention (SMC) project in Katsina state, northern Nigeria, with funding from the Bill & Melinda Gates Foundation. Following new World Health Organisation policy recommendations on SMC, this project administers full antimalarial treatments during the malaria season in areas with highly seasonal malaria transmission, to prevent illness among children under five."

"The project’s objectives are:

• To design, in consultation with key local stakeholders, an appropriate community-based delivery system for SMC in Katsina state based on formative research, which will review aspects relating to feasibility, community acceptability, effectiveness and cost
• To launch and execute SMC delivery according to the selected delivery system and collect data on process indicators and costs
• To evaluate community acceptability, costs and effectiveness of the delivery system for SMC
• To inform future national and state plans for SMC continuation/ scale up by disseminating findings and sharing experiences with key stakeholders"

Malaria Consortium, Project Brief: Seasonal malaria chemoprevention, Katsina, pp. 1-2.

Malaria Consortium told us that it trained over 3,600 CDs and nearly 200 health workers to provide about 1.6 million courses of SMC to roughly 350,000 children who lived in 4 "local government areas" (LGAs) in northern Nigeria in 2012-2014.

Malaria Consortium emails, November 23, 2016 (unpublished).

• "Length of project: 2012-2014 (33 months)," Malaria Consortium, Project Brief: Seasonal malaria chemoprevention, Katsina, p. 1.
• "[In 2013], Total number of children covered = 487,354"; "[In 2014], Total number of children covered = 1,112,330," Malaria Consortium, Cost analysis of the seasonal malaria chemoprevention project in Katsina state, Nigeria, pg. 20. However, compare to "A total of 487,353 treatment courses were delivered in two LGAs over three treatment cycles in the first round of SMC representing an average of 115% coverage over the three cycles. In 2014, a total of 1,078,440 treatments were provided across four LGAs over four cycles with an average of 115% administrative coverage." Malaria Consortium, Monitoring and evaluation summary Nigeria, pg. 2. Our understanding is that about 4 courses of SMC were aimed to be delivered per child, suggesting that about 350,000 to 400,000 children were targeted. (487,354 + 1,112,330) / 4 = 399,921, while (487,353 + 1,078,440) / 4 = 391,448.25.
• "The project also has a number of critical milestones:...85 percent of children targeted receive all courses of SMC in the second round," Malaria Consortium, Project Brief: Seasonal malaria chemoprevention, Katsina, g. 2.
• [Under "Process of implementation 2"]: "Selection and training of 2,500 community caregivers (CHWs) and supervisors to deliver the intervention and complete the necessary forms," Malaria Consortium, SMC presentation, May 6, 2014, Slide 13. Note: Malaria Consortium gave us an updated figure of 3,600 CDs, which is cited above.
• "Intervention area 2013:
  • In consultation with the State MOH and SMCP, four LGAs were chosen
  • Two for implementation of SMC and two for control in 2013
  • Full implementation in four LGAs in 2014," Malaria Consortium, SMC presentation, May 6, 2014, Slide 9.

ACCESS-SMC:

For more details on the ACCESS-SMC program, see this published study. ACCESS-SMC stands for Achieving Catalytic Expansion of SMC in the Sahel.

Unitaid awarded up to $67 million to Malaria Consortium to lead a project called ACCESS-SMC to reach up to 7 million children per year in seven countries in the Sahel region of Africa in 2015-2017.

You can see this working correctly on our site. It is currently footnote 59 at https://www.givewell.org/charities/malaria-consortium

Here is the output of the coverted text, which has three problems:
The @...@ delimiters are still there but do not work;
The space at start and end are converted to

tags in 4.x and not in 3.x;
The HTML entities would be a nightmare for content editors to enter, since they create raw HTML.

<ul>
<li>"Budget: 1,694,339.00 (USD)" @Malaria Consortium, "Support Scale up of Seasonal Malaria Chemoprevention (SMC)"@. We also searched the Gates Foundation's grant database to see whether it made any additional grants to Malaria Consortium for SMC work, but only saw this grant (grant page available at @Gates Foundation, "Malaria Consortium"@).
<li>"Malaria Consortium is implementing and assessing the feasibility of a community-based seasonal malaria chemoprevention (SMC) project in Katsina state, northern Nigeria, with funding from the Bill & Melinda Gates Foundation. Following new World Health Organisation policy recommendations on SMC, this project administers full antimalarial treatments during the malaria season in areas with highly seasonal malaria transmission, to prevent illness among children under five." @Malaria Consortium, Project Brief: Seasonal malaria chemoprevention, Katsina@, Pg 1.
<li>"The project’s objectives are:<ul>
<li>To design, in consultation with key local stakeholders, an appropriate community-based delivery system for SMC in Katsina state based on formative research, which will review aspects relating to feasibility, community acceptability, effectiveness and cost
<li>To launch and execute SMC delivery according to the selected delivery system and collect data on process indicators and costs
<li>To evaluate community acceptability, costs and effectiveness of the delivery system for SMC
<li>To inform future national and state plans for SMC continuation/ scale up by disseminating findings and sharing experiences with key stakeholders" @Malaria Consortium, Project Brief: Seasonal malaria chemoprevention, Katsina@, Pg 2.
</ul>
<li>It appears that this project may have also been related to another major (&pound;89 million) project that Malaria Consortium was working on in Nigeria called "Support to National Malaria Programme (SuNMaP)".
<ul>
<li>"Support to National Malaria Programme (SuNMaP) is an &pound;89 million UK aid funded project that works with the government and people of Nigeria to strengthen the national effort to control malaria. The programme began in April 2008 and [ended] in March 2016.

Led by Malaria Consortium, SuNMaP was jointly managed by a consortium, including lead partners Health Partners International and GRID Consulting, with nine other implementing partners. SuNMaP was implemented in 10 states across Nigeria, including Anambra, Kano, Niger, Katsina, Ogun, Lagos, Jigawa, Enugu, Kaduna and Yobe.

SuNMaP worked with the Nigerian government's National Malaria Elimination Programme (NMEP) to harmonise donor efforts and funding agencies around national policies and plans for malaria control. Project targets were aligned with the National Malaria Strategic Plan and Global Malaria Action Plan. The project aimed to improve national, state and local government level capacity for the prevention and treatment of malaria." @Malaria Consortium, SuNMaP Final Report@, Pg 38.
<li>"July 2013: Result of SuNMaP study on efficacy of sulphadoxine‐pyrimethamine (SP) for intermittent treatment against malaria in pregnancy published. SuNMaP commences seasonal malaria chemoprevention in Katsina State." @Malaria Consortium, SuNMaP Final Report@, Pg 16.
</ul>
</ul>

">

On the same page, footnote 81 (and many others) have a real apostrophe in "Consortium’s" which is not converted by the drush command. Enter one of those in a footnote when using version 4.x, and that footnote (sometimes all foonotes) break.

See https://www.drupal.org/project/footnotes/issues/3414604#comment-15397446 🐛 Support adding the text content within the element Fixed

Thanks for the details. It's certainly not stable yet so there is no commitment to breaking changes in 4x - therefore it is fine and makes sense to as closely as possible match 3x output (while still fixing the various big issues that 3x could never solve like grouping/ama support/wysiwyg support within source, accessibility).

Will work on this as soon as I can. Really appreciate you taking the time to thoroughly test out 4x!

I am grateful that you are so responsive. A look around our content heavy site will show many examples of complex footnotes. Whether we should use a WYSIWYG is an open question, but if Drupal works without one, Footnotes ideally should too.

First thought is probably the simplest solution is to support putting content within <footenotes data-value="5">source test here<footnotes/> rather than only supporting data-text. Then perhaps upgrade path can accept as an arg where you want to move the source text to, defaulting to data-text since I would guess the majority of sites use wysiwyg vs not (though I have no data to back that up).

To note it probably does need to be data-value and not value as noted in 🐛 Data loss: everything before last colon in every footnote is lost when using instead of [fn] syntax Needs work , otherwise it seems some characters cause significant issues.

Will have a bit more of a think about it, and of course also happy to hear your suggestions / opinion.

This does not support converting from plain text to CK Editor 5 based text format though. Perhaps that can be a follow-up as its maybe more of an edge case. Can you check if this MR works for you @John_B?

Updated issue summary

Drush upgrade command to achieve this as well here ✨ Combined: Support adding the text content within the element + Drush upgrade path for 3x to 4x Fixed

Fixed as per combined merge request in ✨ Combined: Support adding the text content within the element + Drush upgrade path for 3x to 4x Fixed .

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