=== Plugin Name === Contributors: cfkurtz, pdfernhout Plugin Name: NarraFirma Plugin URI: https://www.narrafirma.com Tags: stories, narrative, inquiry, survey, social, research, organizations, communities, conflict, participation, PNI Author URI: http://www.cfkurtz.com Author: Cynthia Kurtz and Paul Fernhout Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8 Requires at least: 4.3.1 Tested up to: 6.1.1 Stable tag: trunk Version: 1.5.21 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Participatory Narrative Inquiry in a box. Gather stories and make sense of challenges and opportunities in your community or organization. == Description == NarraFirma is companion software to the textbook [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org). Participatory narrative inquiry is an approach in which groups of people participate in gathering and working with raw stories of personal experience in order to make sense of complex patterns for better decision making. PNI focuses on the profound consideration of values, beliefs, feelings, and perspectives through the recounting and interpretation of lived experience. = What is NarraFirma? = * It's a checklist. NarraFirma provides practical guidance as you work, with questions for you to answer, recommendations based on the conditions you describe, activities that help you make decisions, and just-in-time advice. * It's a journal. NarraFirma helps you keep careful records about what happened in your project, and it gives you places to reflect on what happened. This reminds you to keep learning as you work, and it helps you to document your project for future reference. * It's a kiosk. NarraFirma helps you collect stories, on-line and/or off-line, based on question forms you design (with sample questions you can copy). Because story collection is integrated, there is no need to export or import data. * It's a workstation. NarraFirma helps you explore and interpret patterns in your data (stories and answers to questions about stories), creating annotated visualizations you can use to make sense of the stories you collected. = Why choose NarraFirma? = * It's portable. You can install NarraFirma anywhere, as a WordPress plugin or a Node.js web application. Web hosting is inexpensive, popular, and well supported. You can also install NarraFirma on your local computer and use it off-line. (Whichever installation method you choose, we strongly suggest that you set up SSL security on your web site before collecting or entering confidential or important information. Many hosting providers can help you with this task.) * It's a team player. With NarraFirma your team can work on projects together in real time without having to hand files back and forth. You can plan your project, collect stories, discover patterns, and reflect on what you've learned - together. * It's an open book. NarraFirma is open source software. So if you have a question about how something works, you can just look at the source code to find out. If you need the software to do something it can't do, you can add new functionality yourself or ask someone else to add it. * It works in the real world. One NarraFirma installation supports multiple projects, forms, data sets, and reports. Why? Because real-life story projects are rarely simple or predictable. So go ahead and make a mess. NarraFirma is ready for it. == Installation == To install NarraFirma: 1. Download the NarraFirma plugin (in zip format) from WordPress.org or the [NarraFirma web site](narrafirma.com). 2. In your WordPress dashboard, click on "Plugins," then click "Add New." 3. In the "Add Plugins" page, click "Upload Plugin." 4. Click "Browse," then choose the zip file you downloaded. 5. Click "Install Now." 6. Click "Activate." 7. You should see a new "NarraFirma" menu item in your dashboard menu. Click it. 8. In the screen that appears, create a new project and add some users who can access it. Or you can install NarraFirma from the WordPress plugins directory: 1. In your WordPress installation, click "Plugins." 2. Click "Add New." 3. In the search box, type "narrafirma". 4. When NarraFirma appears, click "Install." 5. Click "Activate." 6. You should see a new "NarraFirma" menu item in your dashboard menu. Click it. 7. In the screen that appears, create a new project and add some users who can access it. == Frequently Asked Questions == = Where can I found out more about participatory narrative inquiry? = Take a look at the book behind NarraFirma, [Working with Stories in Your Community Or Organization: Participatory Narrative Inquiry](http://www.workingwithstories.org) = What should I do if I find a bug? = Tell us about it on the [GitHub issues list](https://github.com/pdfernhout/narrafirma/issues). = What about web security? = We strongly suggest that you set up any web site on which you intend to install NarraFirma with SSL (secure sockets). Your hosting provider should be able to help you do that. == Screenshots == 1. This is the main page of NarraFirma. The sections of the software (and the phases of PNI) are shown in the diagram. Clicking on any of these buttons leads to that section. 2. This the main page for the NarraFirma planning section. Links to all the pages in that section are listed. You can enter reminders for any page; they show up on this page. 3. Here the NarraFirma user is describing the groups of people who will be participating in their project. Describing your groups helps you think about how you should collect stories and what you should do with them. 4. Here the NarraFirma user is doing a little sensemaking exercise based on some stories they told about what might happen when they do the project. Thinking in stories during project planning helps to make better decisions about how to carry out the project. 5. Here the NarraFirma user is deciding how they will collect stories. They are looking at recommendations the software is giving them based on the answers they gave to the questions about their participant groups (see screenshot 3). 6. Here the NarraFirma user is creating questions they will ask people about their stories. 7. Here is the NarraFirma survey form participants see when they tell their stories (or NarraFirma users see when they enter the stories they collected off-line). 8. Here the NarraFirma user is looking at stories as they come in to the collection. They are looking here only at stories told by older people who said the person in their story wanted to be heard. 9. Here the user is looking at patterns in the data (answers to questions) collected. The selected row of the table of patterns (at the top) shows that the questions "How do you feel about this story" and "What is your age" are being compared, creating a contingency (bubble) graph. The user has written an observation about that pattern ("People under 35 more positive") and two interpretations of what that pattern might mean ("More weight on older shoulders" versus "Younger people have lots of energy"). The user has selected some stories on the graph to read; the stories appear in the table at the bottom of the image. 10. Here the NarraFirma user is designing a plan for a sensemaking session, where people will work with the collected stories and patterns to make sense of the topic being explored. 11. Here the NarraFirma user is ansewring questions about the outcomes of the project for each participant group. Those outcomes will determine recommendations for interventions. 12. Here the NarraFirma user is reflecting on the entire project, to learn from it and to keep good records for the future. == Changelog == = 1.5.21 = Added: Import option for multi-choice delimited questions with write-in answers in the same column. Added: On "Write questions about stories/participants" pages, when import options are showing, button to directly access import guide. Added: On "Start story collection" page, button to directly access help on what can be changed in a story form linked to a non-empty story collection. Changed: Improved import guide and help on updating story forms. = 1.5.20 = Added: Spot-check graphs page now has buttons to show selected stories (or random sample) in pop-up window for copying and pasting elsewhere. Added: Spot-check graphs page can now show answers to questions about stories (in a simple format) for copying and pasting elsewhere. Added: Additional warnings to alert the user of read-only mode, in case they edit fields without realizing they are not logged in to an account with editing privileges. = 1.5.19 = Added: Icons that show the actitivies on each page (manage, plan, enter, review, journal, export). Can be turned off in project options. Added: Tips at the bottom of the screen. Can be turned off in project options. Added: Page (in Planning) to help you observe and reflect on a story-sharing conversation. Added: Page (in Planning) to help you build and print a project privacy policy. Added: Journaling pages for reflections at the end of each project phase. Added: In Planning, added a few more questions about participant groups (these new questions are not linked to the recommendations system). Fixed: Bug where a question type was being erroneously required for elicitation questions. (It exists there but is not important.) = 1.5.18 = Added: Validation check to make sure that all questions have types. Added: Validation check to make sure that questions of types that require answer lists (select, radiobuttons, checkboxes) have answer lists. Added: For validation support, if you are editing a list item and you click a page-change button, a message will appear asking you to close the currently open item first. (NF needs you to do this so it can run its validation checks.) Added: Global error pop-up that shows the same message as is posted to the development console (for those who don't know about or can't find the development console). Changed: Improved error reporting when questions that should have but are missing answer lists are imported from CSV. Changed: Improved error message in survey itself when a question that requires an answer list has no answer list. Changed: NF's HTML cleanup process has always interpreted a single angle bracket (<) as the start of an HTML tag (and showed an error if there is no closing bracket). This is a problem for texts like "<25" (an age bracket). Now NF just prints out the < and lets you figure out if it's an incomplete HTML tag. = 1.5.17 = Fixed: Broken link on several help pages. = 1.5.16 = Added: Icons for (nearly) every button. Changed: Simplified header at top of all pages. Changed: Simplified and reorganized all section pages (Planning, Collection, etc). Changed: Removed View and Edit buttons under all "GridWithItemPanel" list tables. Now all items in lists can be edited live, without separate view-only step. Changed: Renamed "Design, generate, or import story forms" page to "Build story forms." Changed: When editing story forms, can now see question texts as well as short names. Changed: Improved validation of short-name fields in questions (eliciting, about stories, about participants, annotation), story forms, story collections, and catalysis reports. Fixed: Bug where activity lists in printed agendas for story-collecting sessions and sensemaking sessions were not properly sorted. Fixed: Error where survey introduction text did not wrap correctly. = 1.5.15 = Changed: Dealt more gracefully with situation in which multi-choice question (checkboxes) was changed to single-choice question (select) after data was collected. Was choking on wrong data type during story export. = 1.5.14 = Fixed: Bug in printing story cards where story-form question-answers were not appearing. = 1.5.13 = Fixed: Bug where choose-questions-for-story-form widget was not matching up questions correctly if question short names had extra (leading or trailing) blank spaces. (Now any extra blank spaces are trimmed off.) Fixed: Bug where extra (empty) lines in choice-question available-answers lists were creating malformed survey HTML, causing the error "Something went wrong loading the survey questionnaire from the server." (Blank lines are now being trimmed out correctly.) = 1.5.12 = Fixed: Bug where the texts of edited stories did not appear correctly in the "Show story texts for copying" popup window on the "Explore Patterns" page. Fixed: Bug where annotations might not match existing stories correctly during import and bulk changes. = 1.5.11 = Fixed: Improved error handling for empty (no-name) questions. Was choking on them during export. = 1.5.10 = Fixed: Bug where write-in answers were missing from the display of submitted stories and answers (which survey-takers can use to save a local copy of what they said). = 1.5.9 = Added: Brief introductory text (with link to WWS book) to home page Added: Section links to home page (on right, below story collections table, for better accessibility) Changed: Moved page descriptions from popup tooltips to texts below page links; shown by default but can be turned off in project admin options Changed: Improved page descriptions to explain what each page is for and why you would want to use it Changed: Section pages (Planning, Collection, etc) now start with graphical icons that echo the home-page diagram (better continuity) Changed: Hid upper-right page navigation buttons (previous, next) in situations in which they had been disabled (gray) Changed: Made all links have a highlighted box when hovered over (for better accessibility) Changed: Consolidated all color designations in main CSS file into CSS vars (to make it easier to tweak colors) Changed: Tweaked some colors to make interface a bit calmer Changed: Removed hard-coded copy of CSS definitions for SVG-PNG conversion (now read directly from DOM); should reduce errors while changing CSS Changed: Default font from "Arial, Helvetica" to "Helvetica, Arial" (looks better?) Fixed: "Explore patterns" page now handles legacy case where observation exists but "remarkable" flag is not set Fixed: Bug where version number was not updated in place that makes correct version appear on Project admininstration page = 1.5.8 = Added: Bulk annotation import from CSV file Fixed: Bug where question links to new story form were not being correctly created (causing it to be impossible to add questions to form) Fixed: Formatting mistakes in help system = 1.5.7 = Changed: In Node.js version, added logout link to choose-project page Fixed: Bug (in WordPress version only) where setting and then deleting read-access permission role/id would allow anonymous read permission = 1.5.6 = Changed: Added "start here" label to home-page diagram, so beginners have a hint at what to click on first Changed: Revamped help system to (a) clarify interactions between pages and (b) add previous-next links between help pages Changed: In story cards, added bold tags so word processors will show selected answers even if style information is lost Changed: While looking at stories in "Review incoming stories" can now see raw JSON story data Fixed: Bug where survey could refuse to save story because it seemed to have no name (though it did) Fixed: Bug where question name with leading or trailing space did not match choice made in story form (now extra spaces are trimmed out) Fixed: Bug where "Active on web?" column on "Start story collection" page showed "checked" for all story collections (instead of yes or no) Fixed: Bug where instructions on "Create project story elements" page were out of synch with changed clustering-diagram interface = 1.5.5 = Fixed: Critical bug in WordPress PHP code that could cause new NarraFirma installations to show a blank screen instead of the setup page = 1.5.4 = Fixed: Small bug in display lumping code that could cause a lumped count to be off when somebody chose and then un-chose an answer = 1.5.3 = Added: Option to set custom graph height as well as width = 1.5.2 = Changed: Improved usability of clustering interface (used in planning and catalysis) Fixed: Improved error message when JSON was expected but HTML was received (the HTML could be an error message; now it is shown) Fixed: Small (probably invisible) bug where id for write-in fields was not given story id prefix = 1.5.1 = Fixed: Bug where catalysis report graphs did not print (list comparison was set backwards, sorry) = 1.5.0 = Added (survey): Multi-lingual surveys (partipant can choose language; choice is saved for graphing) Added (survey): Option to embed introductory video (streaming or mp4) Added (survey): Story collection date question (generated or imported) Added (survey): For all question types, option to allow write-in answer (for "other" answers or follow-up questions) Added (survey): For "select" question type, option to show full list box instead of drop-down list Added (survey): For "select" question type, option to set no-choice text (e.g., "-- select --") Added (survey): For "boolean" question type, option to set yes/no texts Added (survey): For "text" question type, option to set width of textbox (in percentage units) Added (survey): For "radio buttons" and "check boxes" question types, option to include image links to show below answers Added (catalysis): Ability to change annotation questions while answering them (to build answer lists that emerge from reading stories) Added (catalysis): Templates for annotation questions Added (catalysis, sensemaking): Real-time display lumping (merging of similar answers) in catalysis graphs and statistics Added (catalysis, sensemaking): Ability to filter stories by story length Added (catalysis, sensemaking): Ability to filter stories by searching for specific pieces of text Added (usability): Option to set project nickname, which shows on pages and reports within project Added (usability): Buttons to hide or show advanced and import options for questions, story forms, observations Added (usability): Improved text-box widths throughout the pages, so shorter texts have shorter text boxes Added (usability): Better explanation/labeling of cluster order in catalysis clustering Added (usability): Ability to "archive" (hide) WordPress projects Changed (catalysis): Moved annotation facility from collection to catalysis; improved annotation process Changed (usability): Added "choosers" to improve process of adding questions to story forms and changing question order Changed (usability): Shortened length of text boxes for shorter entry fields (e.g., names, labels) Changed (usability): Reduced number of entry fields that appear in situations where they don't apply Changed (usability): Application now checks that your question short name is unique (instead of asking you to check it yourself) Changed (usability): Navigation buttons now say "Previous page" and "Next page" (to make it more clear that you are going to a page, not doing something) Changed (usability): Revamped WordPress launch/options page Changed (stability): Changed almost all "var" variables to "const" or "let" variables Fixed (catalysis): Bug where missing custom graph size for catalysis report could result in printed graphs with zero height Fixed (catalysis): Bug where no-answer answers for boolean and checkbox questions were being graphed as no or false instead of no-answer Fixed (sensemaking): Bug where generated questions (e.g., Eliciting question) still appeared in story cards when their check boxes were unchecked Fixed (sensemaking): Bug where story filter with && combination did not work when printing story cards Fixed (usability): Issue where last few lines of home-page right-side links could pop over to bottom left Fixed (usability): Many small CSS element spacing awkwardnesses Fixed (stability): Bug where application did not load under WordPress when installed on Bedrock server Fixed (stability): Updated Mann-Whitney U test for two improvements in scipy code from which it was derived = 1.4.2 = Added: Option to limit number of multi-choice answers participants can choose in survey Added: Option to "pad" bottom of bar graphs and left/bottom of contingency tables to accommodate large fonts specified in CSS Changed: On bar graphs, removed X axis label - was redundant (same as graph name) Changed: On contingency tables, moved X and Y axis labels to upper-right corner (so they are no longer floating in space) Changed: Improved responsive css styling on slider widget Changed: Made slider value display (to right of slider) tabbable and editable (with Enter) as well as clickable (for accessibility) Changed: Added CSS variables to make it easier to set colors in different survey areas (with custom CSS) Changed: Improved story card display when one or both scale labels are missing Changed: Set resizing on text boxes to vertical only (in survey and in NarraFirma interface) to avoid conflicts with window resizing Fixed: Bug where "Print story cards" button was hidden when advanced options were turned off Fixed: Bug where right arrow on survey, when seen on small (phone) screen, could wrap to next line = 1.4.1 = Added: Message when there are no graphs for a pattern because none had the minimum number of stories to graph Fixed: Bug where expected bubbles on contingency graphs were sometimes too small (statistical results were not affected) Fixed: Spurious message in contingency graph when question has no answer counts = 1.4.0 = Added: Correlation map that shows relationships among all scale questions (overall and by choice question) Added: Ability to save graph data to CSV file (to recreate graph outside NarraFirma) for selected graph or whole catalysis report Added: System for marking patterns as remarkable, unremarkable, to be reviewed, or redundant - improves catalysis workflow Added: Ability to show or hide all columns in pattern table on "Explore patterns" page Added: Non-printing observation note (to remember something about an observation without having it appear in the report) Added: Project options page (for options that affect whole project) Added: Project option to set CSV delimiter for import and export (comma, semicolon, tab) Changed: Better interface for choosing graph types to show on "Explore patterns" page, with graphics Changed: Import system now warns if you try to import floating-point (real) numbers rather than integers for scale data Changed: Better help on graph types on "Explore patterns" page Changed: Limited size of Mann-Whitney statistical results table for contingency-histograms and multiple histograms (can be very long) Fixed: Observation/interpretation with no name now shows description on clustering page (instead of nothing) Fixed: Firefox bug causing help window to be shown in tiny font; now appears in tab but normal sized = 1.3.3 = Added: Separate custom CSS field for graphs only - affects graphs both in application ("Explore patterns" page) and printed report Added: Buttons to hide advanced options from beginners (affects three pages: print story cards, configure catalysis report, print catalysis report) Added: More selection buttons (scales, choices, texts) to question choosing (in configure catalysis report and print story cards) Changed: Simplified CSS class names of graph elements for easier reference in writing custom CSS field = 1.3.2 = Fixed: Bug where SVG files were not being saved to ZIP file = 1.3.1 = Changed: Improved drawing of counts on contingency charts = 1.3.0 = Added: Interface - Ability to create multiple observations per pattern Added: Interface - Ability to include multiple patterns per observation Added: Interface - Ability to save selected pattern image(s) on Explore Patterns page to SVG or PNG (zip file if multiple graphs) Added: Interface - New field: observation "linking question" to introduce multiple interpretations (e.g., "Why do we see this pattern?") Added: Interface - New field: interpretation "questions" to suggest things people can ponder in sensemaking (comes before "idea") Added: Reporting - New catalysis report clustered by themes (groups of observations), with multiple interpretations following each observation Added: Reporting - Option to choose observation strengths (high, medium, low, unassigned) in all catalysis report types Added: Reporting - Can export all images related to observations only (zip file of PNG or SVG images) Added: Reporting - Option to set print order of perspectives/themes during clustering (using "Edit cluster" popup window) Added: Reporting - Option to hide specific observations, interpretations, or clusters from catalysis report (helpful when printing reports for different groups) Added: Reporting - Option to show sequence number in catalysis report for each perspective, theme, observation, and interpretation Added: Reporting - Option to hide report-creation information ("This report was generated") at start of catalysis report Added: Reporting - Option to set label truncation limit on bar and contingency charts Added: Reporting - Can now use simple **bold** and __italic__ formatting in all report fields Added: Graphing - Option to increase or decrease graph font sizes in report graphs by percentage Added: Graphing - Option to hide "no answers" counts (applies to graphs and statistics; choice is saved per report and per pattern) Added: Graphing - Option to replace all graph/statistical texts in catalysis report (e.g., "Count", "mean") to simplify or translate report Added: Graphing - Option to show observed/expected numbers on contingency-table bubbles Added: Graphing - Option to show row/column totals on contingency-table axes Changed: Interface - Statistics calculations on "Explore patterns" page now happen in the background; can click on graphs while statistics are calculating Changed: Interface - Collisions between users editing the same (large text) field are easier to resolve; writing in progress is preserved, and options are avilable to override/accept/edit changes Changed: Interface - Startup message ("Retrieving project information") now shows count of messages loaded Changed: Interface - Lists of questions on "Configure catalysis report" and "Print story cards" pages are now multi-column (less scrolling) Changed: Interface - Better order/flow/explanations of things on "Configure catalysis report" page Changed: Interface - Options relevant only to printing have been moved from "Configure catalysis report" page to "Print catalysis report" page Changed: Interface - "Choose a project" dialog now shows a login link if you are not already logged in Changed: Reporting - Catalysis report now uses HTML headers (H1 through H6) which are more easily converted to styles by word processors Changed: Reporting - Old @header@ system for "sectioning" observations is no longer needed and has been removed (no backward compatibility; copy sections into new observations) Changed: Graphing - In contingency tables and contingency-histogram tables, Y axis now shows answers to question from top to bottom instead of bottom to top Changed: Graphing - "No answer" bars/bubbles/boxes are now last instead of first bars/columns/rows Changed: Graphing - Expected bubble on contingency tables is now red - easier to see (can be changed in custom CSS for report) Changed: Graphing - Squares in contingency-histogram tables are now all the same width, to make it easier to compare means Changed: Clustering - Interpretation/observation item colors now vary by observation strength (which can be switched on or off) Changed: Clustering - You can now select and move multiple items/clusters at once (shift-click, or click and drag selection box) Changed: Clustering - Hover-over hints now show observation name, text, and strength Changed: Clustering - Setting the clustering surface size is easier than it was Fixed: Bug (Interface) where multi-choice answers did not display correctly in the "Show selected stories" popup window Fixed: Bug (Interface) where count of contingency tables and contingency-histogram tables was sometimes wrong on "Configure catalysis report" page Fixed: Bug (Reporting) where custom CSS was not being applied to images in catalysis report Fixed: Bug (Reporting) where "Introduction" field was being ignored in catalysis report printing Fixed: Bug (Export) where exporting story form or stories from "Export stories" page was not working correctly Fixed: Bug (Graphing) where PNGs were empty in printed catalysis report Fixed: Bug (Graphing) where "No answer" bar/bubble/box was being sorted in the middle of answers when some answers were numbers Fixed: Bug (Clustering) where changing size of clustering surface did not update image immediately Fixed: Bug (Clustering) where you could drag an item off the clustering surface = 1.2.6 = Changed: Perspectives in catalysis report are now sorted by their vertical position in the clustering space Changed: Reduced number of debug messages in CSV pre-import check, to prevent error messages from being pushed out by sheer volume of messages on large data sets Fixed: Bug where zero scale values were not being displayed on histograms (we apologize for never having noticed this before) = 1.2.5 = Added: Option to hide statistical panels on Explore patterns page (useful when there are long lists of results to scroll through) Added: Way to view/copy statistical results in pop-up window while looking at graph on Explore patterns page Added: Interpretation count to summary above patterns table on Explore patterns page Changed: Bar graph Y axis label now allocates more space when graph counts need more digits to display Fixed: Bug where showing selected stories was not working correctly in new catalysis report = 1.2.4 = Added: Better options for replacing or keeping existing questions when importing CSV story form Added: Way to export observations, intepretations, perspectives from catalysis report to CSV and import them into new report on different story collection (as long as question names match) Added: Way to view/copy names and texts of random sample of stories (10, 20, or 30) drawn from stories selected on graph Added: Option to see answers to selected (important) questions while viewing/copying stories in graph selection Added: Separate columns in catalysis patterns table for (up to 3) questions referred to by each pattern (so you can sort by each question individually) Added: Option to hide statistical results in printed catalysis report Added: Option to set number of bins for Story length question Added: CSS Class names for graph axis labels depending on graph type (bar, histogram, etc) Added: Summary above catalysis patterns table showing counts of patterns and observations (by strength) Added: Story index (number in story collection) is now displayed in all places where story names are given (lists, story cards), to distinguish between stories with the same name Changed: Filter (for catalysis reports and story cards) can now have negated queries (e.g., include every answer but one) Changed: Filter (for catalysis reports and story cards) can now have multiple questions, creating more complex queries Changed: Better pre-import check messages Changed: Improved handling of clustering in situation where interpretations have texts but no names Changed: Better interface for making and doing things with graph selections Changed: Moved saved graph selection reference from observation text to its own field (that does not appear in printed catalysis report) Changed: Better question groupings on "Configure catalysis report" page Changed: Now if you hover over a dot on a scatterplot and there is more than one story there, it will show you (the first ten of) the story names, instead of just one name/text Changed: In the catalysis pattern table, for side-by-side scatterplots, instead of showing the lowest p value, it now shows the range of p values (which is more relevant) Changed: Statistics panel is now transparent (no longer blue), so it doesn't stick out so much Changed: Better font sizes for various graph axis labels Changed: Better error messages for malformed HTML Changed: Small interface improvements here and there Fixed: Bug where selected pattern in catalyis pattern table would scroll out of view Fixed: Bug where allowing AxA question combinations would also include both AXB and BXA question combinations Fixed: Bug where portion of pre-import check log was being written to browser console when actually importing data Fixed: Bug where answers lumped during import were printing multiple times in story cards Fixed: Various little bugs here and there... = 1.2.3 = Fixed: Critical bug (introduced in v1.2.0) where exporting "project snapshot with stories" was not actually exporting any stories Fixed: Bug where extra result lines were displayed in Mann-Whitney U test (statistics for multiple histograms and contingency-histogram charts) Added: Information on "Configure catalysis report" page telling user how many patterns (graphs, statistical calculations) will be generated by their current selections Added: Warnings when large numbers of patterns will cause the "Explore patterns" page to load slowly (>10K graphs) or the browser to stop responding (>50K graphs) Added: Buttons on "Configure catalysis report" and "Print story cards" pages to select all story questions or participant questions Changed: On "Explore patterns" page, progress bar (shown while calculating statistical results) now updates less frequently, causing the process to run faster = 1.2.2 = Added: Can now run pre-import check and export story form from "Design story forms" page (so you no longer have to create a story collection to do these things) Fixed: Bug where import scale range value of 0 was being ignored Fixed: Bug where story form name was not being set properly Fixed: Bug where newly created question did not have id field set, resulting in an error when you replaced it during import of story form = 1.2.1 = Added: Option to graph multi-choice questions against themselves (to explore coincidences between answers) Changed: Changed "vs" to "x" in graph names, to read better in languages other than English Changed: Increased font size of axis labels (they seem too small now that the graphs are a little bigger) Changed: Made sure graphs of every type have a title at the top; gave title a class; styled it Fixed: Bug where observations-only report did not include observations without the strength value set = 1.2.0 = Added: Many new import options to accommodate/manage/massage CSV data files from a variety of surveying systems Added: Detailed guide to importing data Added: All CSV import options are now specifiable in NarraFirma itself (instead of only through a specification file) Added: Data consolidation (lumping together similar answers) using CSV import Added: Pre-import data check to verify CSV data integrity before actually adding stories to project Added: New graph type - choice by choice by scale, or a contingency table with little pseudo-histogram boxes Added: Added story length question (generated) to graphs Added: Table of links in catalysis report to observations and interpretations for each perspective (sorted by strength) Added: Filter to limit catalysis report to subset of stories based on answer(s) to question Added: Option to print catalysis report with observations only (for group catalysis workshop) and with only particular strengths Added: Option to hide graphs with few stories (applies to multiple histograms/scatterplots on Explore patterns page and catalysis report) Added: Ability to save catalysis report graphs in SVG format rather than PNG (better resolution and can be styled with CSS) Added: Ability to refer to portion of observation name as well as text using @header@ system Added: Button on Explore patterns page to show stories selected in graph (for copying) Added: CSS classes for named elements in catalysis reports (to style particular perspectives, observations, and interpretations) Added: Filter to limit story cards to subset of stories based on answer(s) to question Added: Choice of question sort order when printing story cards: alphabetically or in story form order, with scales separate or mixed in Added: Option to truncate very long stories when printing story cards Added: CSS classes to style particular question names and answers in story cards Added: "Quick links" on home page to access elements of projects (questions, forms, reports, etc) Added: Method to reset (empty out) project, removing "hidden" stories connected to deleted story collections (project admin only) Added: Button to display names of deleted story collections (so you can get them back again, or avoid doing so) Added: Method to archive (hide) old projects (site admin only) Changed: Moved around some buttons and pages in Collection to make it more clear how/where to import and export data Changed: Improved names of graph types on configure catalysis report page (to make it clear why would want each one) Changed: Project import now requires administrator permission (so does new reset function) Changed: Project import now warns user if there is data in the project (questions, forms, collections, reports) Changed: Link to site administration page (formerly called "Administration tool") is now visible only to site administrator (and is now on Home page) Changed: Improved design, organization, explanations of site administration pages in both node.js and WordPress versions Changed: Improved layout of catalysis report pages for multi-graph results Changed: Stress tested with 13K stories; works fine, though slowly (may need increased memory setting at these numbers) Fixed: Bug where "admin" project permission was not being set properly in node.js version (but it was not being used for anything) Fixed: Bug where creating new project with long name in WordPress version caused 500 server error (now name length is restricted to <= 20 characters) Fixed: Bug that caused spurious error messages during report generation Fixed: Bug that caused spurious error messages about missing IDs when creating story forms Fixed: Bug in bar graphs for boolean questions ("no" was being counted as a non-answer) Fixed: Bad handling of missing/empty custom CSS in imported story form file Fixed: Navigate-in-page "name" anchors changed to "id" anchors (because "name" anchors are deprecated in HTML 5) = 1.1.0 = * Added: Optional summary of submitted stories and other data, for participants to copy and save * Added: Human readable project report with all data entered for use outside of software * Fixed: Bug in login link = 1.0.2 = * Added: Notes for questions, to keep track of decisions made while choosing and editing questions * Fixed: All user communications in the survey can now be customized (essential for non-English surveys) = 1.0.1 = * Fixed: Made navigation bar (at top) not scroll (was accidentally made scrolling) * Changed: Updated WordPress screenshots for new version = 1.0.0 = * Added: New data integrity graphs showing overall patterns across all questions (all scale values; per-participant means and sd; number of non-answers) * Added: User definable CSS for on-line and printed surveys, story cards, catalysis report * Added: Qualitative (free-text) answers in catalysis patterns * Added: More user definable fields to customize on-line story collection * Added: Multiple scatterplots to show scale+scale+choice question combinations * Added: Link to choose another project without logging out * Added: Visible slider number (0 to 100) and way to set value precisely * Added: Option to set maximum number of stories participants can tell * Added: Story count per participant (framed as a "question" so it can form patterns with other questions) * Added: Auto-create story form option (using all existing questions) * Added: Can now choose which questions to include on story cards * Added: More control over the look of story cards, including custom CSS but also which questions to include and how to draw ranges * Added: Ability to set all story form options during CSV import * Added: Way to distinguish among participants during import (to count stories per participant) * Added: Scale conversion during import (for scale data collected with ranges other than 0-100) * Added: Field to write (then copy and paste) reminders from Return phase of one project to Planning phase of the next * Added: Way to choose types of graphs to view * Added: Counts above bars in bar graphs and histograms * Added: Correlation lines (optional) in scatterplots * Added: Mode to histograms * Added: Support for multiple observations per pattern (graph) * Added: Observation strength field to sort strong from weak patterns * Added: Interpretations to patterns list (can sort by them) * Added: More options for catalysis graphs including histogram bins, scatterplot dot size and opacity * Added: More user-supplied sections for catalysis report * Added: Unanswered count (number of stories with no answer to the question) to all graphs * Changed: Improved data import, with better error handling and help * Changed: Overhaul of screen designs and color palettes * Changed: Improved statistical information displays; improved reporting on statistical errors * Changed: Better error reporting and alerts to user * Changed: More tips and FAQ items to help system * Changed: More verification of statistical result against same tests in other software (you can't see this but it's important) * Changed: More help in various places to deal with questions people have had * Fixed: Explore Patterns page now shows cancelable progress bar when large numbers of statistical results are being calculated * Fixed: Bug in chi-squared statistical calculation that disqualified too many comparisons * Fixed: Survey image now works * Fixed: Text areas now slightly taller * Fixed: Catalysis "ideas" now print in report * Fixed: Catalysis clustering diagram now updates better for changed interpretatations on previous page * Fixed: No longer showing questions in graphing sections (spot-check graphs, catalysis) that are not used in current story collection * Fixed: Eliciting question now included in spot-check graphs and catalysis * Fixed: Better graph sizing and scaling * Fixed: Statistical results no longer say "p=0.000" when p<0.001 * Fixed: Better feedback when taking survey, showing that story has been submitted and accepted * Fixed: Better error handling for missing or untitled items (like story collections and catalysis reports) * Fixed: Dividing line (hr) no longer displays on story cards when they are being printed = 0.9.8 = * Added clarifying headers and popup hints for all links on dashboard (project phase) pages. * Improved styling and clarity of catalysis report, printed story form, and story cards. * Added story count to Spot-check graphs screen. = 0.9.7 = * Fixed bug in checkbox questions where data was not being stored correctly. * Improved colors, labels, spacing of graphs. * Added story counts to Review stories and Explore patterns screens. * Added "does not apply" check box (configurable) to slider questions. * Improved help on question types. * Improved look of story card display. * Moved annotations to top of Review stories list; colored in green so they stand out. = 0.9.6 = * Sanitize SQL input in WordPress plugin. * Improve TypeScript typings for tsc 1.6. = 0.9.5 = * Improvements for Node.js version and README/SETUP for installation. = 0.9.4 = * Now uses NarraFirma namespace in WordPress plugin PHP to conform with WordPress guidelines. * Fixed WordPress plugin survey bug where always returning first questionnaire added in a topic instead of the last one. = 0.9.3 = * Fixed problem where first two characters of display name are being truncated during CSV export of story form. * Added arrows to sliders in survey form to make it more useful in narrow mobile displays. * Added warning about story collection creation. * Fixed some typos. = 0.9.2 = * More improvements to bundling of JavaScript for faster loading. Also improved startup feedback to show loading application, getting user information, or retrieving project data. = 0.9.1 = * Improvements to bundling of JavaScript code for faster loading. = 0.9.0 = * This is the first publicly released version of NarraFirma. For (highly detailed and entertaining) change logs, see the [GitHub repository](https://github.com/pdfernhout/narrafirma). == Upgrade Notice == = 1.5.21 = This minor upgrade adds a new import option (for multi-choice data with intermingled write-in answers) and improves help for data import and changes to story forms. = 1.5.20 = This minor upgrade 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. = 1.5.19 = This minor upgrade adds more note-taking pages and improves the new-user experience with page-type icons and tips. = 1.5.18 = This minor upgrade helps NF deal more gracefully with information users sometimes forget to provide. It also improves general error reporting. = 1.5.17 = This tiny upgrade fixes several broken links on help pages. = 1.5.16 = This minor upgrade makes many small improvements to clarity and usability. = 1.5.15 = This minor upgrade deals more gracefully with a situation in which a multi-choice question (checkboxes) was changed to a single-choice question (select) after data was collected. = 1.5.14 = This minor upgrade fixes a bug in printing story cards where story-form question-answers were not appearing. = 1.5.13 = This minor upgrade 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. = 1.5.12 = This minor upgrade fixes two bugs: (a) the texts of edited stories did not appear correctly in the "Show story texts for copying" popup on the "Explore Patterns" page, and (b) annotation import and bulk change might not work correctly for edited stories. = 1.5.11 = This tiny upgrade improves error handling for empty (no-name) questions. The application was choking on them during export. = 1.5.10 = This minor upgrade fixes a small bug in which write-in survey answers were being left out of the "this is what you said" copy-and-paste display. = 1.5.9 = This minor "clarity" upgrade makes various small improvements to page descriptions, links, buttons, colors, and fonts. (Note: If you do not like the new page descriptions, you can hide them on the project options screen.) = 1.5.8 = This minor but (yes, again) critical upgrade fixes a bug where the buttons to add questions to a newly created story form did not work. It also adds CSV import for annotations. = 1.5.7 = This minor but critical upgrade fixes a bug (in the WordPress version of NF only) where entering and then deleting a user id or role in the "read access" field for a project caused NF to allow anonymous users to view project pages. = 1.5.6 = This minor but critical upgrade fixes a bug where the survey erroneously believed entered stories had no names. It also fixes a few smaller bugs and improves the help system. = 1.5.5 = This minor but critical upgrade fixes a bug in the WordPress PHP code that could cause new NarraFirma installations to show a blank screen instead of the setup page. = 1.5.4 = This minor upgrade fixes a small bug in the display lumping system. (A lumped count could be off when somebody chose and then un-chose an answer.) = 1.5.3 = This minor upgrade adds the option to set the catalysis graph height as well as width (onscreen and in the printed report). = 1.5.2 = This minor upgrade makes the clustering process (used in planning and catalysis) a little easier. It also fixes a few small bugs. = 1.5.1 = This minor upgrade fixes one tiny but important bug (catalysis report graphs did not print). = 1.5.0 = This major upgrade adds new features for surveying (e.g., write-in answers, multi-lingual surveys) and catalysis (e.g., display lumping, better support for qualitative analysis). = 1.4.2 = This minor upgrade makes some usability changes, improves survey usability and accessibility, and fixes a few small bugs. = 1.4.1 = This minor upgrade fixes a bug in contingency diagram drawing, plus a few other small fixes. = 1.4.0 = This somewhat-major upgrade adds a new type of graph (correlation map) and makes several process/workflow improvements to the catalysis process. = 1.3.3 = This minor update provides a few more usability and capability improvements for the catalysis process. = 1.3.2 = This is a quick fix for a bug that causes SVG files not to be saved to a ZIP file. = 1.3.1 = This tiny upgrade fixes one nagging problem with the drawing of count labels on contingency charts. = 1.3.0 = This major upgrade improves the catalysis process, with many improvements to the interface, graphs, and report creation. = 1.2.6 = This critical upgrade fixes a longstanding bug we just noticed in how histograms are drawn. We apologize for never having noticed this before. = 1.2.5 = This minor upgrade adds a few more options for narrative catalysis. = 1.2.4 = This upgrade improves support for narrative catalysis. It adds several features that help you go through the process more easily. = 1.2.3 = This is a critical upgrade. Please apply it right away. It fixes a bug we introduced in version 1.2.0, in which exporting a project snapshot "with stories" did not actually export any stories. We apologize for the mistake. There is also a fix for a bug in the Mann-Whitney U test (some blank values were being erroneously counted). The update also improves error handling for projects with large numbers of questions. = 1.2.2 = This minor upgrade copies a few buttons (important to importing data) to some more useful places. It also fixes a few annoying bugs. = 1.2.1 = This minor upgrade adds the option to graph multi-choice questions against themselves, to look for patterns in coincidences of answers. It also improves a few visual details and fixes a bug in the observations-only catalysis report. = 1.2.0 = This higly recommended upgrade improves catalysis reports and story cards, and provides many more import options. It also includes many usability improvements and small bug fixes. = 1.1.0 = This upgrade adds two new ways to get your data out of NarraFirma: in the survey, a summary of submitted stories participants can copy and keep; and in the application, an HTML project report that summarizes everything you typed into NarraFirma (for use in other software). = 1.0.2 = This minor upgrade improves your ability to control messages in the story form (especially useful for non-English surveys). It also adds a "notes" fields to each question, so you can keep track of your reasons to use particular questions. = 1.0.1 = This upgrade fixes a small bug in the NarraFirma interface. It also improves the screenshots shown in the WordPress plugins directory. = 1.0.0 = This highly recommended upgrade improves customization of surveys and reports, plus better support for narrative catalysis (finding and exploring patterns). It also includes many usability improvements and small bug fixes. = 0.9.8 = This upgrade improves the clarity and style of the application and some of its reports. This is not a critical release, but it's recommended because it makes the application easier to use. = 0.9.7 = WordPress users should upgrade to this version. It contains a fix for a bug that could lose data in checkbox survey questions. A "Does not apply" option was added for slider questions. There are also some improvements to graphs and usability. = 0.9.6 = WordPress users should upgrade to this version as it contains a security fix. = 0.9.5 = Improvements for Node.js version and README/SETUP for installation. There is no need to upgrade to this version for WordPress users. = 0.9.4 = This upgrade fixes a bug where the web survey always used the first version of a question form and would never disable it. It also uses a NarraFirma namespace in the WordPress plugin PHP file to conform with WordPress guidelines. = 0.9.3 = This upgrade fixes a bug (in CSV export) and a few cosmetic issues. = 0.9.2 = This upgrade affects loading time, and there is a small cosmetic change. = 0.9.1 = This upgrade affects performance only. == Donations == We have spent a lot of time developing NarraFirma. We appreciate donations, and will use them to keep working on it. You can donate at [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DGVVDT2D49QA8). == Need some help? == I offer training in the use of NarraFirma and consulting for PNI projects. If you are interested, check out my web site at [cfkurtz.com](cfkurtz.com), or send me a note at cfkurtz at cfkurtz dot com.