├── .gitignore
├── Csv_import.php
├── README.md
├── doc
└── readme.txt
├── lang
├── strings_dutch.txt
├── strings_english.txt
├── strings_french.txt
├── strings_german.txt
└── strings_italian.txt
└── pages
├── config.php
├── config_edit.php
├── import_issues.php
├── import_issues_inc.php
├── import_issues_page_col_set.php
└── import_issues_page_init.php
/.gitignore:
--------------------------------------------------------------------------------
1 | /.idea/
2 |
--------------------------------------------------------------------------------
/Csv_import.php:
--------------------------------------------------------------------------------
1 | name = plugin_lang_get( 'title' );
6 | $this->description = plugin_lang_get( 'description' );
7 | $this->version = '2.0.0';
8 | $this->requires = array( 'MantisCore' => '2.0.0' );
9 | $this->author = 'Bug 4220 Team';
10 | $this->contact = 'https://github.com/mantisbt-plugins/csv-import/';
11 | $this->url = 'https://github.com/mantisbt-plugins/csv-import/';
12 | $this->page = 'config';
13 | }
14 |
15 | function config() {
16 | return array(
17 | 'import_issues_threshold' => MANAGER ,
18 | );
19 | }
20 |
21 | function hooks() {
22 | return array(
23 | 'EVENT_MENU_MANAGE' => 'csv_import_menu',
24 | );
25 | }
26 |
27 | function csv_import_menu() {
28 | return array(
29 | '' . plugin_lang_get( 'manage_issues_link' ) . '',
30 | );
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | CSV Issues Importer
2 | ===================
3 |
4 | A plugin that imports issues from CSV files.
5 |
6 | Install
7 | -------
8 |
9 | - Download or clone the repository and place it under the MantisBT plugins folder.
10 | Make sure you get the correct version for your MantisBT (See [Compatibility](#compatibility) below).
11 | - Rename the folder to Csv_import (case sensitive)
12 | - Go to Manage - Manage Plugins and install the plugin.
13 | - Go to Manage - Import Issues
14 |
15 | Features
16 | --------
17 |
18 | The plugin supports:
19 |
20 | - auto-creating users as part of import.
21 | - auto-creating categories as part of import.
22 | - custom fields importing.
23 | - importing as new issues.
24 | - updating issues after matching by ids.
25 | - updating issues after matching by selected fields assuming a single match.
26 |
27 | A few hints about usability
28 | ---------------------------
29 |
30 | - Have a separate csv file per project.
31 | - Switch to the project before importing.
32 | - If the goal is to add the rows from csv, then make sure to map Id fields (if in CSV) to be ignored.
33 | - If the id is supplied, then issues with be updated based on data from the csv after matching by id.
34 | - Users that are auto-created will
35 | - be disabled
36 | - have random passwords,
37 | - have email as `username@localhost`.
38 |
39 | Compatibility
40 | -------------
41 |
42 | Depending on which version of MantisBT you are using, please make sure to
43 | get the appropriate version of the source code.
44 | Use [release tags](https://github.com/mantisbt-plugins/csv-import/releases),
45 | or the relevant branch in the Plugin's GitHub repository, as per the table below:
46 |
47 | MantisBT version | Plugin version | Branch
48 | :---:|:---:|---
49 | 2.x | v2.x | [master](https://github.com/mantisbt-plugins/csv-import/archive/master.zip)
50 | 1.3.x | v1.5.x | [master-1.3.x](https://github.com/mantisbt-plugins/csv-import/archive/master-1.3.x.zip)
51 | 1.2.x | v1.4.1 | [master-1.2.x](https://github.com/mantisbt-plugins/csv-import/archive/master-1.2.x.zip)
52 |
53 | Support
54 | -------
55 |
56 | Report issue in the [MantisBT bug tracker](https://mantisbt.org/bugs)
57 | under the **Plugin - CsvImport** project.
58 |
59 | However, please note that this plugin is not actively supported by its original authors.
60 |
--------------------------------------------------------------------------------
/doc/readme.txt:
--------------------------------------------------------------------------------
1 | Mantis Issue Importer
2 | =====================
3 |
4 | History:
5 | ________
6 |
7 | Version | Author | Action
8 | --------------------------------------------------------------------------------------
9 | 1.3.0b | lionheart33806 | Added "primay key" feature
10 | | (sorry for my english) | Bug fixes (updates were impossible, sometimes first column was ignored)
11 | | | Removed "alternative import" feature (original import is RFC compliant !!)
12 | | | Column detection is less strict
13 | | | Some HTML and PHP format corrections
14 | | | Corrected some errors display
15 | 1.2.0 | lionheart33806 | import_issues_page.php splitted to become
16 | | | import_issues_page_init.php and import_issues_page_col_set.php
17 | | | Can create unknown categories
18 | | | Little JS to use tab as separator
19 | 1.1.5 | lionheart33806 | Code closer of mantis coding conventions
20 | | | "all projects" categories reusable
21 | | | Can import "submitted date" with DD/MM/YYYY format
22 | | | Checkbox for alternative import
23 | | | because of double quotes
24 | | | Added helper_begin_long_process() for very long imports
25 | 1.1.4 | Stéphane Veyret | Add german version of jojow
26 | 1.1.3 | Stéphane Veyret | Make the strings "private" with plugin_lang_get
27 | | | Add french version
28 | 1.1.2 | Udo Sommer and Cas Nuy | Transformed into plugin
29 | 1.0 | Stéphane Veyret | Improvements
30 | (old) | ave | Importer creation
31 |
32 |
33 | Known Issues:
34 | _____________
35 |
36 | * Please, see https://github.com/lionheart33806/Csv-import-4-MantisBT/issues
37 |
38 |
39 | Licence:
40 | ________
41 |
42 | The licence of CSV Import remains untouched, means GPL,
43 | as stated in THE GPL.
44 |
45 |
46 | Installation:
47 | _____________
48 |
49 | Create a "Csv_import" directory in "plugins" directory of mantis.
50 | Extract all the files in "Csv_import".
51 |
52 | In "Manage" module, you should find "Import CSV file".
53 |
54 | NB : "Csv_import" is case sensitive.
55 |
56 |
57 | Function:
58 | _________
59 |
60 | Imports/update one or more issues from a CSV text file into the current project of Mantis.
61 |
62 |
63 | Requirements:
64 | _____________
65 |
66 | Made for and tested against Mantis version 1.2.0
67 |
68 |
69 | Usage:
70 | ______
71 |
72 | Take care that this importing functionality can make a mess in your database. It is recommanded that you make
73 | a backup of your database before importing.
74 |
75 | Dates can be given with timestamp, "European" (d-m-y) or American (m/d/y) format.
76 |
77 | 1. In the "Manage" menu, select "Import CSV file".
78 |
79 | 2. Select the file to import. Your file must be in a correct CSV format (see above), and must only contain
80 | importable columns. The first line of the file can be a title line. In that case do not forget to
81 | select "Skip first line".
82 |
83 | 3. Select the "Import file" button.
84 |
85 | 4. The importer will try to recognize if the file use standard column names, or the name as given in
86 | your current language.
87 | If the importer did not detect your columns automatically, select them. Please, always verify the columns.
88 | If you import many times from an another bug tracker, you should previously create a custom field which will contain
89 | the other bug tracker bug id. Then, check in "Primay key" column the line corresponding to the custom field.
90 |
91 | If you define a column as a mantis ID, "primary key" checkboxes will be ignored.
92 |
93 | 5. Select the "Import" button.
94 |
95 | 6. Review the results to ensure they are as expected.
96 |
97 |
98 | About CSV format:
99 | _________________
100 |
101 | Be sure your file is RFC compliant
102 | Look at :
103 | http://tools.ietf.org/html/rfc4180
104 | or
105 | http://en.wikipedia.org/wiki/Comma-separated_values
106 |
--------------------------------------------------------------------------------
/lang/strings_dutch.txt:
--------------------------------------------------------------------------------
1 |
12 |
13 |
14 |
15 |