Releases: pdfernhout/narrafirma
NarraFirma v1.5.22
This minor NarraFirma release fixes one tiny mistake: I forgot to save one file (package.json) with the new version number in the previous release. That's all.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.22.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.22.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.21
This minor release adds a new import option (for multi-choice data with intermingled write-in answers). It also improves help and guidance for data import and for changes to story forms that are connected to non-empty story collections.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.21.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.21.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.20
This minor release adds two things: more noticeable warnings when you have read-only access to a project; and a bit more information on the "spot-check graphs" page.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.20.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.20.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.19
This minor release improves several aspects of completeness. It adds more note-taking questions and pages, filling in some gaps on things you might want to remember about your project. It adds two more Planning pages (Observe story sharing and Build privacy policy) that will help you get your projects moving. And it adds two forms of help for new users: page-type icons (manage, plan, enter, review, journal, export) and tips. Both new forms of help can be turned off by more experienced users. For more details on these changes check out the NF blog post.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.19.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.19.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.18
This minor release makes a change to how you use NarraFirma that might be annoying for a while. But it's a good thing.
NarraFirma has always had a capacity for data validation, meaning that it can check to make sure you haven't put in the wrong data or left things out that were necessary. But we didn't use NF's validation system much. Usually people would figure out they were missing data in other ways, like that their survey didn't work. But that's a frustrating and painful way to find out that you are missing information!
So, with this update, when you create or change a question, NF will check to see if the question has a short name and a type, and it won't let you stop editing the question until you fix the problem. If it's the kind of question that should have a list of answers (select, radiobuttons, or checkboxes), NF will also check to see that you did indeed enter a list of answers.
So what's the annoying thing? It's that the NF data validation system lives in the editing panel that appears when you click on a thing in a list. It's that little window-in-the-window with the Close button at the top.
I don't remember why the validation system lives in that panel. But it does, and that means validation can only happen within that panel. Years ago, when we first built the validation system, the only thing it did was to check that the story form you associated with a story collection existed. That is why there is a long scary warning about "Click the Close Buttton!" on the "Start story collection" page. But now there are three more types of validation, it's not a good thing that you can thwart the validation system by simply clicking on a button located outside the editing panel.
As a result, in this release I have changed how the page-change buttons work. If you have the editing panel open (showing anything that appears in a list), and you click on a page-change button, NF will ask you to close the panel before you change the page. This will probably be somewhat annoying until you get used to it. However, it will help you avoid problems that arise when you forget to enter information NF needs to make your survey (and your project) work.
I also made two smaller changes:
- You can use simple HTML tags in your NF survey texts. Hence, when NF encounters a less-than angle bracket (<) it has always assumed that you were trying to embed an HTML tag, and it looked for a closing symbol (>). However, I noticed that when people are asking people about their age, they often want to use the < symbol numerically, as in "<20". In this release I changed the code so that NF now prints a lone < symbol rather than stopping and complaining that your HTML is malformed. If you do intend to use an HTML tag and forget the closing bracket, you will have to fix it yourself; but that's probably less likely (and less trouble) than getting stuck on a numerical symbol that won't print.
- I've had a lot of email (or GitHub) exchanges in which I asked people to look in their browser's development console and tell me what it said there, because when NF encounters an error that's where it says what happened. It always takes people a while to figure out how to do that. So in this release, I added a global error handler that shows you a pop-up alert with the same error message as you can read in the console. Hopefully this will help people get help fixing problems sooner.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.18.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.18.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.17
This tiny release just fixes a bug in which some help links were wrongly capitalized.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.17.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.17.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.16
This minor release is an anti-verbosity pro-clarity update. It slims down verbiage, removes irritating barriers, and add useful information.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.16.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.16.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.15
This minor release deals more gracefully with a (reported) situation in which a multi-choice question (checkboxes) was changed to a single-choice question (select) after data was collected. NF was choking when the stories were being exported. In general it is best not to make changes to question types after stories have been collected. However, NF should now handle this particular situation more gracefully, by posting warnings to the development console (and exporting the data anyway) rather than refusing to work.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.15.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.15.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.14
This minor release fixes a bug in printing story cards where story-form question-answers were not appearing.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.14.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.14.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.13
This minor release fixes two tiny bugs you might have run into if you had extra (blank) leading or trailing spaces in your question short names, or if you had extra (empty) lines in your available-answers lists. NF now deals more elegantly with both situations.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.13.zip) from the link you see on this page. Then upload the zip file into the plugins section of a running WordPress installation. Caution! Don't mix up the WordPress zip file (narrafirma-wordpress-plugin-v1.5.13.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.