{"id":4805,"date":"2016-06-28T11:46:00","date_gmt":"2016-06-28T09:46:00","guid":{"rendered":"http:\/\/wppa.nl\/?page_id=4805"},"modified":"2021-09-01T13:47:36","modified_gmt":"2021-09-01T11:47:36","slug":"custom-data","status":"publish","type":"page","link":"https:\/\/wppa.nl\/fr\/docs-by-subject\/custom-data\/","title":{"rendered":"Custom data"},"content":{"rendered":"

How it works<\/h3>\n

In Basic settings -> I -> Items 11 and 12<\/strong> of the Photo Albums -> Settings<\/em> admin page, you can activate the use of Custom Datafields. Each album and each photo (or video or photo with audio) can have up to 10 customized data fields stored with the album \/ photo info. As soon as you define the Title (= caption) of the field, it exists. You can also decide if a field may be visible, and if a field may be editable at the front-end of the website. The checkboxes on every line in the tables in Advanced settings -> Custom data<\/strong> define if the item may be seen \/ edited at front-end. <\/p>\n

\"3796\"<\/div>
<\/div><\/path><\/path><\/svg><\/div><\/div>\n\n

On the Photo Albums -> Album admin -> Edit Album information -> Manage Photos admin page, you will see the input fields for the custom data right below the Description<\/strong> input area.<\/p>\n

\"3797\"<\/div>
<\/div><\/path><\/path><\/svg><\/div><\/div>\n\n

The photo description may contain wppa keywords w#cc0 .. w#cc9<\/strong> to display the captions of the custom data fields, w#cd0 .. w#cd9<\/strong> to display the data of the respective fields. In this example the description reads as follows:<\/p>\n

<table><tbody>\r\n<tr><td>w#cc0<\/td><td>w#cd0<\/td><\/tr>\r\n<tr><td>w#cc1<\/td><td>w#cd1<\/td><\/tr>\r\n<tr><td>w#cc2<\/td><td>w#cd2<\/td><\/tr>\r\n<tr><td>w#cc4<\/td><td>w#cd4<\/td><\/tr>\r\n<\/tbody><\/table>\r\nUploaded: w#timestamp<\/pre>\n
Resulting in this output:  
\"3798\"<\/div>
<\/div><\/path><\/path><\/svg><\/div><\/div>\n<\/p>\n
As you can see, the line with the telephon number (w#cc3 and w#cd3) is left out, because the corresponding box is not chekced so it will not display anyway.<\/p>\n
The captions as well as the data itsself may be plain text only, without html tags. Any formatting should be done in the description field.<\/p>\n
qTranslate shortcodes are supported, e.g.: [<\/b>:en]Name[<\/b>:nl]Naam[<\/b>:fr]Nom[<\/b>:]<\/b> can be a Caption, [<\/b>:en]Yellow[<\/b>:nl]Geel[<\/b>:fr]Jaune[<\/b>:]<\/b> can be a custom field content, supporting English, Dutch and France languages.<\/p>\n
Bulk input of custom data<\/h3>\n
You can bulk input custom data from a .csv (comma separated values) file.
\nThe file must have the following format:
\nLine 1 contains a search indicator<\/em>, either name<\/strong>, photoname<\/strong> or filename<\/strong> followed by the captions<\/em> of the custom datafields. The case of the characters ( upper -lowercase ) of the search indicator<\/em> is not important, the captions<\/em> must exactly meet the existing captions as defined in Advanced settings -> Custom data -> I: Photo custom data fields configuration<\/strong> if they are already defined. If they are not yet defined, they will be created. Note that there is a maximum of 10 fields, supplying more data will fail.<\/p>\n
The second and subsequent lines contain the search value<\/em> and the custom data values<\/em> that correspond with the captions<\/em>.<\/p>\n
If the search indicator<\/em> is photoname<\/strong>, all the photos with that name will get the supplied data in the custom data fields.
\nIf the search indicator<\/em> is filename<\/strong>, the photos will be searched by their filename.
\nIf the search indicator<\/em> is name<\/strong>, the photos will be searched by their name and filename.<\/p>\n
Note that multiple photos can get the same custom data this way.<\/p>\n
Example file:<\/p>\n
\r\nPhotoname,Sponsored By,Message,Email,Age,City,Major\r\nEvie Leiby,Gold's Gym,Get well.,evie@xxx.com,6,Buffalo,Math\r\nKhalil Golden,ABC Company,It's going to be ok.,gold@yyy.com,,Fredonia,Electronics\r\nAlaeya Martin,Reeds Gems,Wishing you well.,martina@zzz.org,7,Williamsville,Nursing\r\nShamari Bolton,Pet Emporium,\"Hold on, it will all work out.\",,12,Buffalo,Sociology\r\n<\/pre>\n
If you have the csv file ready, ftp it to your depot directory (You can find it on the Photo Albums -> Import Photos<\/strong> admin page usually ...\/wp-content\/wppa-depot\/[loginname]\/). The file MUST have the extension .csv<\/strong> to be recognized.<\/p>\n
After ftp-ing the file, open the Import screen. If there are more files in your depot, you may see the white Start Ajax<\/strong> button adjacent to the blue Import<\/strong> button. Use the Import button, the Ajax button will not work for this operation.<\/p>\n
If it takes more time than 30 seconds, the procedure will auto restart. During processing, the datalines of which the corresponding photo(s) is\/are found will be removed from the file. If the procedure comes to an end and the file is still there, it will contain the data lines of photos that were not found. The size in kb of the file will be updated every 30 seconds, so you can see the progression. (In my test 10.000 lines were processed within 30 seconds, but it can vary depending on the speed of the database. 2 queries per line are required).
\n<\/a><\/p>\n
Bulk input of system data<\/h3>\n
The possible items to import using this procedure has been extended to some system<\/strong> data fields, that may be combined in the same .csv file for the custom data fields.
\nThe folowing fields are importable:<\/p>\n
\r\n'album',\t\t\/\/ bigint(20) NOT NULL,\r\n'name',\t\t\t\/\/ text NOT NULL,\r\n'description',\t\t\/\/ longtext NOT NULL,\r\n'p_order',\t\t\/\/ smallint(5) NOT NULL,\r\n'linkurl',\t\t\/\/ text NOT NULL,\r\n'linktitle',\t\t\/\/ text NOT NULL,\r\n'linktarget', \t\t\/\/ tinytext NOT NULL,\r\n'owner', \t\t\/\/ text NOT NULL,\r\n'timestamp', \t\t\/\/ tinytext NOT NULL,\r\n'status', \t\t\/\/ tinytext NOT NULL,\r\n'tags',\t\t\t\/\/ text NOT NULL,\r\n'alt',\t\t\t\/\/ tinytext NOT NULL,\r\n'modified',\t\t\/\/ tinytext NOT NULL,\r\n'location',\t\t\/\/ tinytext NOT NULL,\r\n'views',\t\t\/\/ bigint(20) NOT NULL default '0',\r\n'clicks',\t\t\/\/ bigint(20) NOT NULL default '0',\r\n'exifdtm', \t\t\/\/ tinytext NOT NULL,\r\n<\/pre>\n
Make sure the values have the right format! Note that the formats, like \/\/ tinytext NOT NULL,<\/code> as listed above, are for your reference only, do not include them in your .csv file!
\nThe first item on the headerline (the search indicator<\/em>) MUST be filename<\/strong> when you bulk import system fields.
\nIt simply works now as follows: If a 'system' datafieldname is found in the .csv headerline, it is assumed to be the system data field, else it is assumed to be a custom data field.
\nThere is no way to import a .csv file for album custom fields.
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
How it works In Basic settings -> I -> Items 11 and 12 of the Photo Albums -> Settings admin page, you can activate the use of Custom Datafields. Each album and each photo (or video or photo with audio) can have up to 10 customized data fields stored with the album \/ photo info. [...]<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":4738,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4805","page","type-page","status-publish","hentry","post-seq-1","post-parity-odd","meta-position-corners","fix"],"_links":{"self":[{"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/pages\/4805","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/comments?post=4805"}],"version-history":[{"count":3,"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/pages\/4805\/revisions"}],"predecessor-version":[{"id":6706,"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/pages\/4805\/revisions\/6706"}],"up":[{"embeddable":true,"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/pages\/4738"}],"wp:attachment":[{"href":"https:\/\/wppa.nl\/fr\/wp-json\/wp\/v2\/media?parent=4805"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}