Differences

This shows you the differences between two versions of the page.

--- plugin:vcard [2012-07-20 09:40] – works with Angua, no idea of olders glen
+++ plugin:vcard [2020-02-23 14:45] (current) – version upped Aleksandr
@@ Line 4: / Line 4: @@
 description: Creates vCards/hCards that can be downloaded and added to your addressbook
 author     : Elan Ruusamäe, Jürgen A.Lamers, Esther Brunner
-email      : glen@delfi.ee, jaloma.ac@googlemail.de, wikidesign@gmail.com
+email      : glen@delfi.ee
 type       : syntax
-lastupdate : 2012-07-19
+lastupdate : 2016-02-03
-compatible : Angua
+compatible : Angua+
 conflicts  :
 similar    :
 tags       : vcard, address, hcard, users
-downloadurl: http://github.com/glensc/dokuwiki-plugin-vcard/zipball/master
+downloadurl: https://github.com/glensc/dokuwiki-plugin-vcard/zipball/master
-bugtracker : http://github.com/glensc/dokuwiki-plugin-vcard/issues
+bugtracker : https://github.com/glensc/dokuwiki-plugin-vcard/issues
-sourcerepo : http://github.com/glensc/dokuwiki-plugin-vcard/
+sourcerepo : https://github.com/glensc/dokuwiki-plugin-vcard
 ----
 ===== Installation =====
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Description =====
-This [[plugins|plugin]] lets you create vCard files on the fly in your wiki, which other users can download and add to their addressbook. With the [[folded]] plugin installed, you can unfold information about the person right in your wiki.
+This plugin lets you create vCard files on the fly in your wiki, which other users can download and add to their addressbook. With the [[folded]] plugin installed, you can unfold information about the person right in your wiki.
 The output the plugin will produce looks like this:
@@ Line 32: / Line 30: @@
 {{http://qwik.kaffeehaus.ch/_media/dokuwiki/full_vcard.png}}
+{{http://tomas.valenta.cz/dokuwiki/vcard-example.png|vCard plugin example}}
 ===== Usage =====
@@ Line 37: / Line 37: @@
 Example:
-  {{vcard>[organisation] Full Name <email@host.com> http://www.host.com 1976-05-03 # +41 43 534 0462 | Street Nr., ZIP City, Country}}
+  {{vcard>[Organisation] Full Name <name@example.org> http://www.example.org 1976-05-03 # +41 43 534 0462 | Street Nr., ZIP City, Country}}
+  {{vcard>[Kriminálka] Kapitán Dastych <kapitan@dastych.cz> http://www.dastych.cz 1997-2-11 # work & mobile & home & fax | Protiprávní 12, 11000 Praha, Czech replublic }}
 All information besides the name is optional. Here are the parameters:
+**Fields in first part (before #)**
+  - **[company]** - company name
   - **Name**: space delimited words; the first is considered to be the first name, the last to be the last name; everything in between will be middle / additional name.
   - **E-Mail**: enclosed in < and > signs.
   - **Website**: only http is recognized.
   - **Birthday**: in format yyyy-mm-dd.
-  - **Phone Number(s)**: after a ''#'' sign; multiple numbers are delimited by an & sign
-    - the first is considered as **home phone**
-    - the second as **cell phone**
-    - the third as **work phone**
-    - and the fourth as **fax number**
-  - **Address**: after a | sign; comma delimited with
-    - first **street**
-    - then **zip-code**
-    - and **city**
-    - and finally **country**.
-===== To Do =====
-  * There are some encoding problems with converting the vCard to quoted-printable and Apple Addressbook doesn't recognize UTF-8.
+**Second part (between # and |) are phone numbers separated by & in order**
+  - the first is considered as **home phone**
-==== Preview ====
+  - the second as **cell phone**
+  - the third as **work phone**
-{{http://tomas.valenta.cz/dokuwiki/vcard-example.png|vCard plugin example}}
+  - and the fourth as **fax number**
-==== Usage ====
-  {{vcard>[Kriminálka] Kapitán Dastych <kapitan@dastych.cz> http://www.dastych.cz 1997-2-11 # work & mobile & home & fax | Protiprávní 12, 11000 Praha, Czech replublic }}
-**Fields in first part (before #)**
-  * [company] - company name
-  * name - first name, middle name //optional// and surname
-  * <email> - email address
-  * %%http://address.example.org%% - website, must have http prefix
-  * yyyy-mm-dd - birthday
-**Second part (between # and |) are numbers separated by & in order**
-  * work number
-  * cell phone number (mobile phone)
-  * home number
-  * fax number
 **Third part is address; there are three field separated by commas**
+  - first **street**
+  - then **zip-code** and **city** (separated by space)
+  - and finally **country**.
-  * street address
+===== To Do =====
-  * zip and city separated by space
-  * country
+  * There are some encoding problems with converting the vCard to quoted-printable and Apple Addressbook doesn't recognize UTF-8.
 ===== Development =====
@@ Line 95: / Line 70: @@
 The patches and fixes from this page are merged and removed from wiki page, if something important was removed, feel free to recover it from history.
 === Authors ===
@@ Line 109: / Line 83: @@
     * reordered folded details rendering
   * hCard support by [[jaloma.ac@googlemail.de|Jürgen A.Lamers]] ([[https://github.com/glensc/dokuwiki-plugin-vcard/commit/cb34766cdbdb4a10b9fbd6cf953a2291cb9877bb|cb34766]])
-  * Maintained by [[glen@delfi.ee|Elan Ruusamäe]]
+    * Test your tag-Environment... cause 'span-div-p' sequence maybe has some curious result to your layout. -- //Jürgen A.Lamers// 2008/01/18
+  * Now maintained by [[glen@delfi.ee|Elan Ruusamäe]]
 Rewritten version by [[bruno@defraine.net|Bruno De Fraine]] [[vcard#rewritten version|further below]] (not merged yet)
 === Change Log ===
-{{rss>http://github.com/glensc/dokuwiki-plugin-vcard/commits/master.atom date}}
+{{rss>https://github.com/glensc/dokuwiki-plugin-vcard/commits/master.atom date}}
 ===== Rewritten version =====
@@ Line 155: / Line 129: @@
 ===== Discussion =====
+**NOTE:** Don't post patches, bug reports or feature requests here. Use the [[https://github.com/glensc/dokuwiki-plugin-vcard/issues|Bug Tracker]] instead.  --- [[user>glen|glen]]
+==== Bugs ====
-==== Note/Question regarding Filename & File Suffix ====
+Well, i get some differences between the export with the vcard-export-url and the Firefox-Extension [[https://addons.mozilla.org/en-us/firefox/addon/operator/|operator]]. Some time i will fix this...  --- Anonymous coward
-Hi, just installed the plugin. I realized two things , don't know if i would call them bugs:
-  - If you click the vcard link the file which gets saved is only the firstname, not firstname_lastname  as i think it should be.
-  - There is no suffix @ the end of the filename. As far as I know, the standard suffix for vCards is ".vcf" Makes it easier for Applications.
-Is it possible to change it so that the resulting overall filename:  is <firstname_lastname.vcf>  ? That would be great.
-- Michael (keep up the good work , you create great plugins!)
-  - Is there a way to add job title?
-- Tom
-=== Bugs ===
-Well, i get some differences between the export with the vcard-export-url and the Firefox-Extension ''operator''. Some time i will fix this...
-=== Hints ===
-  * Using the hCard-Feature, you can not change the text ''work'', ''home'' etc. to your desired language.
-  * Test your tag-Environment... cause 'span-div-p' sequence maybe has some curious result to your layout.
- -- //Jürgen A.Lamers// 2008/01/18