utilitees

- Addons for ExpressionEngine 1.6.x

Field Trek Documentation

Download Download


Requirements

  • This module will not work on ExpressionEngine versions prior to 1.6.8.
  • To import / export field groups a folder named field_trek is created below your themes directory. This folder must be read-/writeable by EE. In case the module fails to create the folder appropriately on its own it will ask you to grant permissions manually.
Back to top


Installation

  1. Unzip the file.
  2. Upload the folder field_trek and the contained files to the modules-folder inside your EE system directory.
  3. In your Control Panel navigate to CP Home ›  Modules, find the Field Trek module and click Install.
  4. Now you can click on Field Trek in the modules list to access its Control Panel.
Back to top


Cloning a field group

Step 1:

In the Field Trek Control Panel choose Clone a field-group in this installation.

Step 2:

To the left you are presented with a list of all currently existing field groups (from all sites if you have MSM installed). Select the field group you wish to clone.
To the right you have to choose the target site (if more than one) and a new name for the cloned field group.

Click the “Continue”-button.

Step 3:

In Step 3 you may optionally remove and / or add prefixes to your fields. As field names must be unique within a site you need prefixes if you clone a group to the same site.

If your source field names already contain a prefix specify it to the left if you want it removed prior to cloning. You can specify a prefix for the target field names on the right hand side.

Whatever you do, the module will ensure that your action will neither result in any duplicate field names within a site nor in field names that are reserved words.

If you want to exclude some fields from cloning you can do this by ticking the corresponding checkboxes in the field list to the left.

Click the “Continue”-button.

That’s it. Your field group has been cloned.

Back to top


Exporting a field group

Step 1:

In the Field Trek Control Panel choose Export a field group to a file.

Step 2:

You are presented with a list of all currently existing field groups (from all sites if you have MSM installed). Select the field group you wish to export.

Click the “Continue”-button.

Step 3:

Your field group will be exported to a file and saved into the /themes/field_trek-folder. You may download it right away using the link provided.

Back to top


Importing a field group

Importing a field group is almost identical to clonig a field group.

Step 1:

In the Field Trek Control Panel choose Import a field group from a file.

Step 2:

To the left you can select a file to import from those currently present in your field_trek-folder. You can also dircetly upload files using the file-field below. Select the field group file you wish to import.
To the right you have to choose the target site (if more than one) and a new name for the imported field group.

Click the “Continue”-button to proceed.

Step 3:

In Step 3 you may optionally remove and / or add prefixes to your fields.

If your source field names already contain a prefix specify it to the left if you want it removed prior to cloning. You can specify a prefix for the target field names on the right hand side.

Whatever you do, the module will ensure that your action will neither result in any duplicate field names within a site nor in field names that are reserved words.

If you want to exclude some fields from importing you can do this by ticking the corresponding checkboxes in the field list to the left.

Click the “Continue”-button.

That’s it. Your field group has been imported.

Back to top


Some notes on FieldFrame support

Field Trek supports Brandon Kelly’s FieldFrame extension, meaning that all fieldtype-settings will be duplicated as well. There are however some things you need to be aware of:

  • If you try to import a field group from an installation that has FieldFrame to an installation without FieldFrame a warning will be issued. You can then either install FieldFrame on the target site prior to importing or you proceed without doing so. In the latter case any fieldtype settings will be ignored.
  • If your fieldtype settings contain site- or installation-specific data (e.g.path or URL information) you need to manually adjust that in your new field group.
  • When exporting/importing between different ExpressionEngine installations it is of course beneficial if you have the same fieldtypes installed in both of them.
Back to top


Some notes on Gypsy support

Field Trek supports Brandon Kelly’s Gypsy extension, meaning that fields marked as gypsy-fields will be marked as gypsy-fields after import as well. Gypsy’s weblog assignment setting will be resetted on the imported site though because it’s unlikely that the weblog IDs match on both sites.

  • If you try to import a field group from an installation that uses Gypsy to an installation without Gypsy a warning will be issued. You can then either install Gypsy on the target site prior to importing or you proceed without doing so. In the latter case any Gypsy settings will be ignored.
Back to top

Questions / bug reports

For general comments, brickbats & bouquets please use the form over here.
Name:

Email:

URL:


Remember my personal information
Notify me of follow-up comments?


Page 1 of 1 pages

User Talk

Matthew Gonzalez:
2010-07-28 15:31

When a field group is copied from Site A to Site B in the multi-site manager, will a whole new set of columns be created for the fields?



smartpill:
2010-06-24 22:06

I just tried to import two Matrix 2.0.6 fields and it only imported the first column of the matrix as the field. Has this been updated for Matrix 2?



Michael C.:
2010-05-31 21:01

Dang, the HTML got wiped. Let’s try this:

elevator : Elevator
ac : Air Conditioning
heating : Central Heating
balcony : Balcony / Porch
bars : Barred Windows
garden : Garden / Yard
mamad : Sealed/Safe Room<img class=“icon post help” alt=”(?)” title=”&quot;Mamad&quot; - ממ&quot;ד” src=”/images/icons/silk-icons/help.png”/>
machsan : Storage Room<img class=“icon post help” alt=”(?)” title=”&quot;Machsan&quot; - מחסן” src=”/images/icons/silk-icons/help.png”/>
parking : Reserved Parking

Ok, that looks good in the preview… here’s to consistency…



Michael C.:
2010-05-31 20:57

Bug Report: When cloning a field group containing an FF Checkbox Group with the following “Checkbox Options”, the cloned field’s “Checkbox Options” was empty.

Checkbox Options content:

elevator : Elevator
ac : Air Conditioning
heating : Central Heating
balcony : Balcony / Porch
bars : Barred Windows
garden : Garden / Yard
mamad : Sealed/Safe Room/images/icons/silk-icons/help.png
machsan : Storage Room/images/icons/silk-icons/help.png
parking : Reserved Parking


———————

I’m thinking either the quotation marks or the UTF-8 Hebrew characters caused a problem.



Jack Brighton:
2010-05-20 02:30

Yep, that sounds on the right track. Of the LG addons on the exporting EE system I’ve got:

LG Polls: Controller (v.1.0.6)
LG Polls: Poll Question (v.1.0.6)
LG Social Bookmarks (v.2.0.2)
LG Data Matrix (v.1.1.1)

I’m not using LG Data Matrix since Brandon Kelly’s FieldFrame came out. This might be the one.

Other extensions:

Solspace Software Update (v.1.0.1)
Filter By Author (v.1.0)
Multi Text (v.110) (used for some legacy custom field groups)
Edit Tab AJAX (v.1.2.2)
File, by Mark Huot (v.3.1.1)
Blis Publish Button (v.1.0.3)
Category Checkboxes (v.1.1.5)
Edit Menu (v.1.0.2)
FieldFrame (v.1.4.2) (same version and Fieldtypes installed in all EE instances)
MX Title Conrol (v.0.0.3)
CM faviconizEE (v.1.1.0)
Gypsy (v.1.0.6)
Sitemap Pinger (v.1.5)
Publish Page Improvements (v.2.0.1)
jQuery for the Control Panel (v.1.1.2)
Last_segment (v.1.0.2)
Stand Alone Entry Form Enctype (v.1.0.0)

In Modules I’ve got:

Entry Rating
Discussion Forum
Freeform
LG Polls
Sitemap
MP3 Info +

More than you probably needed to know, just being thorough. smile



Oliver:
2010-05-19 22:22

OK, you seem to have installed an addon that tinkers with EE’s tables. Probably from Leevi Graham. Could you list other 3rd party stuff you have installed?



Jack Brighton:
2010-05-19 21:40

I jut noticed that I could clone a field group within one EE instance, no problem. The error occurs when I export a field group from one EE instance into another. Both are running 1.6.9, PHP 5, MySQL 5. I made sure the themes/field_trek folder is writable by EE.



Jack Brighton:
2010-05-19 21:29

After importing a field group, and getting past the screen to delete or add a prefix, exclude fields, etc., I’m getting a SQL error:

MySQL ERROR:

Error Number: 1054

Description: Unknown column ‘lg_field_conf’ in ‘field list’

Any ideas what’s gone wrong?

Thanks,
Jack



Oliver:
2010-03-17 12:28

I sent you a mail.



Terry Evans:
2010-03-16 22:13

I just purchased FieldTrek and am having some issues.
I am running EE 1.6.8 Build:  20100121
I successfully exported a field group from one site, and am now trying to import it to another. I got a success message stating that the field group and all fields were imported; yet if I navigate to the field groups are of the CP there are none listed. However, if I go to export a field group in the module it shows the field group I just created, yet when I export it the contents of the file are not the same as the one I imported, moreover, these are the values “a:0:{}#silenz#a:0:{}#silenz#FALSE”

Please help!

Cheers
Terry