|
At this point you have a 100023_import.mdb import database
(from the example in previous chapters) stored within "Desktop_Tools\Import"
folder. If there are image attachments exist for this import, then
resized images would be located in "Resized Images\100023_import"
folder (as per example described in "Processing Images" chapter).
Important: Before you upload MS
Access Import Database to your classified for the import, ALWAYS
open it in an MS Access application and run from the menu:
Tool > Database Utilities > Compact and Repair Database...
This would ensure error-less database (internal structure) and
shrink the size of the database.
Getting ready for Import
-
Open your site in an FTP and upload 100023_import.mdb
into the import folder (created during plug-in setup).
-
If images would be attached, then:
Open
000000 folder (also created during plug-in setup in
cl_upload) and create another subfolder 100023_import inside 000000
folder. So
that you have structure cl_upload/000000/100023_import.
This is the folder where attached images for the current upload
would be located. Each Import routine would require a specific
folder to be created (inside 000000) for the
image attachments to the ads within that import. Upload images
from a "Resized Images\100023_import" folder at your desktop
into a newly created cl_upload/000000/100023_import folder.
You are now ready to proceed with Ads Import.
Depending on a type of template you have received form a client,
choose the appropriate Ads Import or Ads Import Plus
method below.
Ads Import
-
From Admin Tasks page select "Ads Import"
and then "New Import".
-
First step is to specify the user account ID
under which the imported ads would be posted. If you received
the template named 100023_import.xls then the user ID
would be 100023. But you may verify that in a User
Manager for the user who requested Ads Import and sent you a
template. Type 100023 at "Type a user account ID" field and
click "Continue".
-
Next screen would provide the User Account
details and prompt to select database and images folder
location. Select database you have uploaded (the 100023_import.mdb
in
this example) and if planning to attach images to ads, select a
folder name where images for THIS Import routine are stored (100023_import
for this example).
Note: If you select "No Images attached", then "images"
field content for each ad would NOT be imported into classified
database even if "images" field is not empty.
By clicking "Evaluate Database", the content of 100023_import.mdb
would be comprehensively analyzed and if inconsistencies are
found (those which might invalidate Rapid Classified database
after the import) you would be notified about each one of them.
You cannot go further with the Import until all inconsistencies
are rectified. Among them: missing mandatory fields, category
field structure which is not understood by a script or non
existed category ID within categories field, missing images
which are specified within "images" field ... etc.
-
If your database successfully evaluated, you
would be directed to the final and actual Ads Import Tool page.
At the bottom-left you may click "Bulk Preview" link to preview
imported ads. The format of preview page is different form the
classified full ads view page, but it does contain all the
information within the ads data including images.
-
At the Ads Import Tool page you would need to
provide additional information which is common for all ads
imported from currently selected import database.
- Specify Import Name (identifies a particular import
within the imports list at the Import management page) and
Import Comment.
- Select a number at Select Image Attachments Limit. This
number is unrelated to the number of images currently attached
to the ad, but restricts future image attachments during ad edit
by a client. Note: if an ad has 3 images attached
for instance and you selected 2 at Select Image Attachments
Limit then 3 images would still be attached. However, if
client decided to change an image later on, then after 1 image
is removed, client would not be able to attach another image as the
limit is set to 2.
- Select Select Ads Duration. This must be a number in
days. If you would like for the ads never to expire, place some
high number, like 10000.
- Select a price for each ad within the import. This must be a
number. It might be used for a manual ad repost after expiration
in Credits Mode. Else it is not relevant in Free or Package
Mode.
- Select yes/no at Ads Description in HTML Format. This
is important. If you select no, then the natural carriage
returns or new line character in an ads description would be
converted into HTML <br> tag for a proper display of a new
lines. If you select yes, then the script assumes the ads
description is formatted as an HTML and no additional processing
required for new lines handling.
-
Click "Stat Import". Depending on a number
of ads, the process might be taking a while. Once import is
finished you would receive a message about successful Import. All
Imported ads go online right away. No approval required. See
"Import Management" chapter for further details.
Ads Import Plus
-
The "Converting Data" and "Processing Images"
chapters referenced to the "Ads Import" method.
Respective example for database and images folder name was
100023_import. The method of data conversion and image
processing is exactly the same for the "Ads Import Plus"
method. Hence the example for this part of the manual would
refer as 100023_import_Plus. So it is save to assume that
the database name is 100023_import_Plus.mdb and images
folder cl_upload/000000/100023_import_plus (for this
example).
-
From Admin Tasks page select "Ads Import
Plus"
and then "New Import".
-
Select database you have uploaded (the 100023_import_plus.mdb
in
this example) and if planning to attach images to ads, select a
folder name where images for THIS Import routine are stored (100023_import_plus
for this example).
Note: If you select "No Images attached", then "images"
field content for each ad would NOT be imported into classified
database even if "images" field is not empty.
By clicking "Evaluate Database", the content of 100023_import_plus.mdb
would be comprehensively analyzed and if inconsistencies are
found (those which might invalidate Rapid Classified database
after the import) you would be notified about each one of them.
You cannot go further with the Import until all inconsistencies
are rectified. Among them: missing mandatory fields, category
field structure which is not understood by a script or non
existed category ID within categories field, missing images
which are specified within "images" field ... etc.
-
If your database successfully evaluated, you
would be directed to the final and actual Ads Import Plus Tool page.
At the bottom-left you may click "Bulk Preview" link to preview
imported ads. The format of preview page is different form the
classified full ads view page, but it does contain all the
information within the ads data including images.
-
At the Ads Import Plus Tool page you would need to
provide additional information which is common for all ads
imported from currently selected import database.
- Specify Import Name (identifies a particular import
within the imports list at the Import management page) and
Import Comment.
- Select a number at Select Image Attachments Limit. This
number is unrelated to the number of images currently attached
to the ad, but restricts future image attachments during ad edit
by a client. Note: if an ad has 3 images attached
for instance and you selected 2 at Select Image Attachments
Limit then 3 images would still be attached. However, if
client decided to change an image later on, then after 1 image
is removed, client would not be able to attach another image as the
limit is set to 2.
- Select Select Ads Duration. This must be a number in
days. Note: The duration may be specified for each
ad individually within the database template for Ads Import Plus
method. If the duration specified individually, then the
individual number would take precedence over the duration
indicated at the Ads Import Plus page.
- Select a price for each ad within the import. This must be a
number. It might be used for a manual ad repost after expiration
in Credits Mode. Else it is not relevant in Free or Package
Mode.
- Select yes/no at Ads Description in HTML Format. This
is important. If you select no, then the natural carriage
returns or new line character in an ads description would be
converted into HTML <br> tag for a proper display of a new
lines. If you select yes, then the script assumes the ads
description is formatted as an HTML and no additional processing
required for new lines handling.
- Select Amount of credits to apply to each newly created user
account by filling Apply Credits to each User account.
- Select a Package to apply to each newly created user account
by selecting from a drop-down list at Apply a package to each
user account.
- If you have user optional fields, then they would be listed in
a next few lines. If user optional fields are filled within the
template, then they would be applied to user account. However
you may control whether or not include those fields with the
ads. Uncheck the box next to user options, which you do NOT wish
to include with ads.
-
Click "Stat Import". Depending on a number
of ads, the process might be taking a while. Once import is
finished you would receive a message about successful Import.
All Imported ads go online right away and user accounts become
active. No approval required.
-
All new user accounts would have a generated
user name. The user name would be constructed as "userID-Import".
So if a new user id is 100251 then user name would be
100251-Import. This is done to preserve user name uniqueness. At
the same time each new user would receive a notification email
(this email may be edited in Content Management - template
Account_Import). It basically notifies a user about new
account and sends a generated password for the logon. At this
point user may logon to the account and change generated user
name/password.
-
Duplicate email and accounts handling.
User database cannot have duplicate emails. Therefore each
record in an imported database is evaluated for duplicates. If
the same email found in database, the account would not be
created. The ad however would be posted and attached to the
discovered in a database user account.
|