Releases: pdfernhout/narrafirma
NarraFirma v1.6.1
This essential release fixes three things.
- In the last update I introduced a show-stopper of a bug that means you can't create story collections in a project that has none already. Sorry, that was sloppy of me. It is fixed now.
- We tested NF with a lot of users at the same time, and a whole bunch of bugs popped up, and we fixed them.
- Third, I realized (through the help of a user) that the display lumping and filtering systems assume that the answers in your fixed-answer-list questions have no leading or trailing white-space characters. This has now been fixed, on both sides: if you have them, NF trims them off, and you can no longer enter answer lists with leading or trailing white-space characters.
I have written much more about these bug fixes in a post on the narrafirma.com blog. (Every new release has a blog post there with more details.)
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.6.1.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.6.1.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.6.0
This major release improves handling of data conflicts, adds item duplication and multi-column story cards, and removes the horrid "Please click the close button" popup.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.6.0.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.6.0.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.24
This essential release fixes a bug in which stories appeared out of order in the survey form.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.24.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.24.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-narrafirma.
NarraFirma v1.5.23
This essential release fixes a bug I thought I had fixed a long time ago. I stupidly thought it would be nice if, when adding questions to a story form, you could see the long as well as short names. Doing this broke the assignments. I thought I had fixed the problem! I hadn't. Now it is fixed.
To use the WordPress version of NarraFirma, first download the zip file (narrafirma-wordpress-plugin-v1.5.23.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.23.zip) with the source code file (narrafirma.zip).
For more installation instructions, go to https://narrafirma.com/home/setting-up-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.